應用常需偵測裝置目前網路類型(Wi-Fi、行動網路)與連線狀態,以決定是否執行同步、下載大檔等操作。本文示範使用 ConnectivityManager 的標準做法,並說明 Android 10+ (API 29) 的新 API 遷移重點。
ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo mobileInfo = cm.getNetworkInfo(ConnectivityManager.TYPE_MOBILE);
NetworkInfo wifiInfo = cm.getNetworkInfo(ConnectivityManager.TYPE_WIFI);
boolean isMobileConnected = mobileInfo != null && mobileInfo.isConnected();
boolean isWifiConnected = wifiInfo != null && wifiInfo.isConnected();
if (isMobileConnected) Log.d("Net", "行動網路已連線");
if (isWifiConnected) Log.d("Net", "Wi-Fi 已連線");
ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
// 1. 取得當前啟用的 Network
Network activeNetwork = cm.getActiveNetwork();
if (activeNetwork == null) {
// 無網路
return;
}
// 2. 取得 NetworkCapabilities 判斷傳輸類型
NetworkCapabilities caps = cm.getNetworkCapabilities(activeNetwork);
boolean hasInternet = caps != null && caps.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);
boolean isWifi = caps != null && caps.hasTransport(NetworkCapabilities.TRANSPORT_WIFI);
boolean isMobile = caps != null && caps.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR);
Log.d("Net", "Internet: $hasInternet, WiFi: $isWifi, Mobile: $isMobile");
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Android 12+ 需額外權限以取得詳細傳輸類型 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
// 註冊 Callback (建議在 Application 或長壽命元件)
NetworkCallback callback = new NetworkCallback() {
@Override
public void onAvailable(@NonNull Network network) { /* 有網路 */ }
@Override
public void onLost(@NonNull Network network) { /* 斷網 */ }
@Override
public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities caps) {
// 類型變化(如 Wi-Fi 切 4G)
}
};
cm.registerDefaultNetworkCallback(callback);
// 解除註冊(onDestroy 等)
cm.unregisterNetworkCallback(callback);
NetworkCapabilities;若需相容舊版可用 Build.VERSION.SDK_INT 判斷分支。NET_CAPABILITY_INTERNET 及 NET_CAPABILITY_VALIDATED 兩項 capability。掌握新舊 API 差異,即可在所有 Android 版本穩健偵測網路狀態。