萬盛學電腦網

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

Android 監聽網絡/WiFi 狀態變化:兩種註冊方式與三大廣播詳解

三大核心廣播

WifiManager.WIFI_STATE_CHANGED_ACTIONWifiManager.NETWORK_STATE_CHANGED_ACTIONConnectivityManager.CONNECTIVITY_ACTION
Action 常數觸發時機關鍵 Extra
WiFi 開關狀態變化 (啟用/停用/啟用中/停用中)`EXTRA_WIFI_STATE` (int: WIFI_STATE_ENABLED/DISABLED/ENABLING/DISABLING/UNKNOWN)
WiFi 連接狀態變化 (連接/斷開/獲取 IP 等)`EXTRA_NETWORK_INFO` (NetworkInfo)、`EXTRA_BSSID`、`EXTRA_WIFI_INFO`
**所有網絡連接狀態變化** (WiFi/移動/藍牙/VPN 等)`EXTRA_NETWORK_INFO` (NetworkInfo)、`EXTRA_NO_CONNECTIVITY`、`EXTRA_OTHER_NETWORK_INFO`

注意:Android 7.0+ (API 24) 限制靜態註冊 `CONNECTIVITY_ACTION`,**必須動態註冊**或用 `NetworkCallback`。

方式一:Manifest 靜態註冊 (適用非 CONNECTIVITY_ACTION)

<receiver android:name=".NetworkChangeReceiver" android:exported="false">
    <intent-filter>
        <action android:name="android.net.wifi.WIFI_STATE_CHANGED" />
        <action android:name="android.net.wifi.STATE_CHANGE" />
        <!-- android.net.conn.CONNECTIVITY_CHANGE 在 API 24+ 靜態註冊無效 -->
    </intent-filter>
</receiver>

方式二:代碼動態註冊 (推薦、全版本通用)

public class MainActivity extends AppCompatActivity {
    private NetworkChangeReceiver receiver;
    private IntentFilter filter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        receiver = new NetworkChangeReceiver();
        filter = new IntentFilter();
        filter.addAction(WifiManager.WIFI_STATE_CHANGED_ACTION);
        filter.addAction(WifiManager.NETWORK_STATE_CHANGED_ACTION);
        filter.addAction(ConnectivityManager.CONNECTIVITY_ACTION);
    }

    @Override
    protected void onResume() {
        super.onResume();
        registerReceiver(receiver, filter);
    }

    @Override
    protected void onPause() {
        super.onPause();
        unregisterReceiver(receiver);
    }
}

BroadcastReceiver 實作詳解

public class NetworkChangeReceiver extends BroadcastReceiver {
    private static final String TAG = "NetChange";

    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();

        // 1. WiFi 開關狀態
        if (WifiManager.WIFI_STATE_CHANGED_ACTION.equals(action)) {
            int state = intent.getIntExtra(WifiManager.EXTRA_WIFI_STATE, WifiManager.WIFI_STATE_UNKNOWN);
            switch (state) {
                case WifiManager.WIFI_STATE_ENABLED: Log.i(TAG, "WiFi 已開啟"); break;
                case WifiManager.WIFI_STATE_DISABLED: Log.i(TAG, "WiFi 已關閉"); break;
                case WifiManager.WIFI_STATE_ENABLING: Log.i(TAG, "WiFi 開啟中..."); break;
                case WifiManager.WIFI_STATE_DISABLING: Log.i(TAG, "WiFi 關閉中..."); break;
            }
        }

        // 2. WiFi 連接狀態 (關聯具體熱點)
        if (WifiManager.NETWORK_STATE_CHANGED_ACTION.equals(action)) {
            NetworkInfo info = intent.getParcelableExtra(WifiManager.EXTRA_NETWORK_INFO);
            if (info != null) {
                NetworkInfo.State state = info.getState();
                Log.i(TAG, "WiFi 連接狀態: " + state); // CONNECTED, DISCONNECTED, CONNECTING...
                if (state == NetworkInfo.State.CONNECTED) {
                    WifiInfo wifiInfo = intent.getParcelableExtra(WifiManager.EXTRA_WIFI_INFO);
                    String ssid = wifiInfo != null ? wifiInfo.getSSID() : "未知";
                    Log.i(TAG, "已連接: " + ssid);
                    // 可在此觸發同步、上傳等操作
                }
            }
        }

        // 3. 通用網絡連接變化 (推薦用於判斷「有無網」)
        if (ConnectivityManager.CONNECTIVITY_ACTION.equals(action)) {
            ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
            NetworkInfo active = cm.getActiveNetworkInfo(); // 當前活躍網絡
            boolean connected = active != null && active.isConnected();
            Log.i(TAG, "網絡整體狀態: " + (connected ? "已連接" : "斷開") + " 類型: " + (active != null ? active.getTypeName() : "無"));

            // 兼容舊 API 獲取變化的網絡
            NetworkInfo changed = intent.getParcelableExtra(ConnectivityManager.EXTRA_NETWORK_INFO);
            if (changed != null) {
                Log.d(TAG, "變化網絡: " + changed.getTypeName() + " " + changed.getState() + " " + changed.getDetailedState());
            }
        }
    }
}

現代替代:NetworkCallback (API 21+)

不依賴廣播,更精準、支援請求網絡能力:

ConnectivityManager cm = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkRequest request = new NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
    .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
    .build();

ConnectivityManager.NetworkCallback callback = new ConnectivityManager.NetworkCallback() {
    @Override public void onAvailable(Network network) { Log.i(TAG, "網絡可用: " + network); }
    @Override public void onLost(Network network) { Log.i(TAG, "網絡丟失: " + network); }
    @Override public void onCapabilitiesChanged(Network network, NetworkCapabilities nc) {
        boolean hasInternet = nc.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);
        Log.i(TAG, "能力變化: hasInternet=" + hasInternet);
    }
};

cm.registerNetworkCallback(request, callback);
// 記得在 onDestroy/unregister 時呼叫 cm.unregisterNetworkCallback(callback)

權限需求

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Android 10+ 掃描 WiFi 需額外權限 -->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
copyright © 萬盛學電腦網 all rights reserved