萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 判斷網路連線狀態(Wi-Fi / 行動網路)完整教學

前言

應用常需偵測裝置目前網路類型(Wi-Fi、行動網路)與連線狀態,以決定是否執行同步、下載大檔等操作。本文示範使用 ConnectivityManager 的標準做法,並說明 Android 10+ (API 29) 的新 API 遷移重點。

傳統寫法 (API < 29)

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 已連線");

現代寫法 (API 29+ 推薦)

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);

常見問題

Q: getNetworkInfo() 在 Android 10 失效?
A: 已棄用,請改用 NetworkCapabilities;若需相容舊版可用 Build.VERSION.SDK_INT 判斷分支。
Q: 如何偵測「有訊號但無法上網」?
A: 檢查 NET_CAPABILITY_INTERNET 及 NET_CAPABILITY_VALIDATED 兩項 capability。

掌握新舊 API 差異,即可在所有 Android 版本穩健偵測網路狀態。

copyright © 萬盛學電腦網 all rights reserved