| 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`。
<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);
}
}
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());
}
}
}
}
不依賴廣播,更精準、支援請求網絡能力:
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" />