核心實作:ConnectionChangeReceiver
public class ConnectionChangeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
ConnectivityManager cm = (ConnectivityManager)
context.getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo activeInfo = cm.getActiveNetworkInfo(); // 當前活躍網路
NetworkInfo mobileInfo = cm.getNetworkInfo(ConnectivityManager.TYPE_MOBILE); // 行動網路
if (activeInfo != null) {
Toast.makeText(context, "活躍網路: " + activeInfo.getTypeName(), Toast.LENGTH_SHORT).show();
boolean connected = activeInfo.isConnected();
// 根據 connected 做業務邏輯 (如重連、暫停下載)
}
if (mobileInfo != null) {
Toast.makeText(context, "行動網路: " + mobileInfo.getTypeName(), Toast.LENGTH_SHORT).show();
}
}
}
Manifest 註冊 (靜態,常駐)
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<receiver android:name=".receiver.ConnectionChangeReceiver">
<intent-filter>
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
</receiver>
動態註冊 (推薦,生命週期可控)
// 在 Activity/Service 中
private ConnectionChangeReceiver receiver = new ConnectionChangeReceiver();
@Override
protected void onResume() {
super.onResume();
registerReceiver(receiver, new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION));
}
@Override
protected void onPause() {
super.onPause();
unregisterReceiver(receiver);
}
Android 7.0+ (N) 重要變更
- CONNECTIVITY_ACTION 廣播不再發送給靜態註冊的 Receiver。
- 必須使用 動態註冊 或
JobScheduler / WorkManager 配合 NetworkCallback。
現代最佳實踐:ConnectivityManager.NetworkCallback (API 21+)
ConnectivityManager cm = (ConnectivityManager) getSystemService(CONNECTIVITY_SERVICE);
NetworkRequest request = new NetworkRequest.Builder()
.addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.build();
cm.registerNetworkCallback(request, new ConnectivityManager.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) { /* 能力變化 */ }
});
// 記得在 onDestroy 中 unregisterNetworkCallback(callback)