BroadcastReceiver (廣播接收器) 是 Android 四大組件之一,用於接收系統或應用發送的廣播訊息。採用發布-訂閱模式,支援跨進程通訊。系統廣播由系統服務發送,如開機完成、網路變化、電池狀態、通話狀態等。
| 特性 | 靜態註冊 (Manifest) | 動態註冊 (程式碼) |
|---|---|---|
| 生命週期 | 應用安裝後常駐,即使應用未啟動也能接收 | 隨註冊元件 (Activity/Service/Application) 生命週期 |
| 啟動延遲 | 可能延遲 (系統需先啟動應用進程) | 即時,進程已運行 |
| 適用場景 | 開機啟動、套件安裝/移除、系統級事件 | UI 相關、網路狀態、暫時性監聽 |
| Android 8+ 限制 | 大多數隱式廣播禁止靜態註冊 | 不受限制 |
| 權限控制 | android:permission 屬性 | registerReceiver 參數指定 |
<!-- AndroidManifest.xml -->
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="com.example.bootreceiver">
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- Android 10+ 需額外權限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<application ...>
<receiver
android:name=".BootCompleteReceiver"
android:enabled="true"
android:exported="true"> <!-- API 31+ 必須指定 exported -->
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
<!-- Android 8+ 需額外指定 -->
<action android:name="android.intent.action.QUICKBOOT_POWERON" />
<action android:name="com.htc.intent.action.QUICKBOOT_POWERON" /> <!-- HTC -->
</intent-filter>
</receiver>
<!-- 若需在開機後啟動 Service,建議使用 JobScheduler/WorkManager -->
<service
android:name=".BootService"
android:exported="false"
android:foregroundServiceType="dataSync" />
</application>
</manifest>
public class BootCompleteReceiver extends BroadcastReceiver {
private static final String TAG = "BootCompleteReceiver";
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
Log.d(TAG, "Received: " + action);
if (Intent.ACTION_BOOT_COMPLETED.equals(action)
|| "android.intent.action.QUICKBOOT_POWERON".equals(action)) {
// ⚠ 注意:onReceive 執行於主執行緒,限時 10 秒 (前台) / 60 秒 (背景)
// 耗時操作必須啟動 Service 或 WorkManager
// 方案一:啟動 Foreground Service (Android 8+ 必須)
Intent serviceIntent = new Intent(context, BootService.class);
ContextCompat.startForegroundService(context, serviceIntent);
// 方案二:使用 WorkManager (推薦,延遲可接受)
// WorkManager.getInstance(context).enqueue(new OneTimeWorkRequest.Builder(BootWork.class).build());
// 方案三:安排 AlarmManager 精確鬧鐘
// scheduleExactAlarm(context);
}
}
}
public class NetworkMonitor {
private static final String TAG = "NetworkMonitor";
private final Context context;
private final ConnectivityManager connectivityManager;
private final NetworkCallback networkCallback;
private boolean registered = false;
public NetworkMonitor(Context context, OnNetworkChangeListener listener) {
this.context = context.getApplicationContext();
this.connectivityManager = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
this.networkCallback = new NetworkCallback(listener);
}
/** 開始監聽 (在 onStart/onResume 呼叫) */
public void start() {
if (registered) return;
NetworkRequest request = new NetworkRequest.Builder()
.addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
.addTransportType(NetworkCapabilities.TRANSPORT_ETHERNET)
.build();
connectivityManager.registerNetworkCallback(request, networkCallback);
registered = true;
Log.d(TAG, "Network monitoring started");
}
/** 停止監聽 (在 onStop/onPause 呼叫) */
public void stop() {
if (!registered) return;
connectivityManager.unregisterNetworkCallback(networkCallback);
registered = false;
Log.d(TAG, "Network monitoring stopped");
}
private static class NetworkCallback extends ConnectivityManager.NetworkCallback {
private final OnNetworkChangeListener listener;
NetworkCallback(OnNetworkChangeListener listener) { this.listener = listener; }
@Override
public void onAvailable(@NonNull Network network) {
Log.d(TAG, "Network available: " + network);
if (listener != null) listener.onNetworkAvailable(network);
}
@Override
public void onLost(@NonNull Network network) {
Log.d(TAG, "Network lost: " + network);
if (listener != null) listener.onNetworkLost(network);
}
@Override
public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities capabilities) {
boolean hasInternet = capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);
boolean isWifi = capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI);
boolean isCellular = capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR);
if (listener != null) {
listener.onCapabilitiesChanged(network, hasInternet, isWifi, isCellular);
}
}
}
public interface OnNetworkChangeListener {
void onNetworkAvailable(Network network);
void onNetworkLost(Network network);
void onCapabilitiesChanged(Network network, boolean hasInternet, boolean isWifi, boolean isCellular);
}
}
// 在 Activity/Fragment 中使用
public class MainActivity extends AppCompatActivity {
private NetworkMonitor networkMonitor;
private TextView statusText;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
statusText = findViewById(R.id.status_text);
networkMonitor = new NetworkMonitor(this, new NetworkMonitor.OnNetworkChangeListener() {
@Override
public void onNetworkAvailable(Network network) {
runOnUiThread(() -> statusText.setText("網路已連線"));
}
@Override
public void onNetworkLost(Network network) {
runOnUiThread(() -> statusText.setText("網路已斷開"));
}
@Override
public void onCapabilitiesChanged(Network network, boolean hasInternet, boolean isWifi, boolean isCellular) {
runOnUiThread(() -> {
String type = isWifi ? "Wi-Fi" : (isCellular ? "行動網路" : "其他");
statusText.setText("網路: " + type + (hasInternet ? " (有網際網路)" : " (無網際網路)"));
});
}
});
}
@Override
protected void onStart() {
super.onStart();
networkMonitor.start();
}
@Override
protected void onStop() {
super.onStop();
networkMonitor.stop();
}
}
| Action 常數 | 觸發時機 | 靜態註冊限制 (Android 8+) | 關鍵 Extra |
|---|---|---|---|
| ACTION_BOOT_COMPLETED | 開機完成 | 允許 | 無 |
| ACTION_POWER_CONNECTED/DISCONNECTED | 充電器連接/斷開 | 禁止 | 無 |
| ACTION_BATTERY_LOW/OKAY | 電量低/恢復 | 禁止 | level, scale, plugged |
| ACTION_BATTERY_CHANGED | 電池狀態變化 (黏性廣播) | 僅動態註冊 | level, scale, status, health, technology, temperature, voltage |
| CONNECTIVITY_ACTION (棄用) | 網路連線變化 | 禁止 | networkInfo, bFailover |
| ACTION_AIRPLANE_MODE_CHANGED | 飛航模式切換 | 允許 | state (boolean) |
| TelephonyManager.ACTION_PHONE_STATE_CHANGED | 通話狀態變化 | 允許 (需 READ_PHONE_STATE) | state, incoming_number |
| ACTION_NEW_OUTGOING_CALL | 撥出電話 | 允許 (需 PROCESS_OUTGOING_CALLS) | EXTRA_PHONE_NUMBER |
| ACTION_SCREEN_ON/OFF | 螢幕開啟/關閉 | 僅動態註冊 | 無 |
| ACTION_USER_PRESENT | 使用者解鎖 | 允許 | 無 |
| ACTION_TIME_CHANGED/TICK | 時間變更/每分鐘 | 允許/僅動態 | 無 |
| ACTION_LOCALE_CHANGED | 語言/地區變更 | 允許 | 無 |
| ACTION_CONFIGURATION_CHANGED | 配置變更 (旋轉、字體等) | 禁止 | 無 |
| MediaStore.ACTION_MEDIA_MOUNTED/UNMOUNTED | 外部儲存掛載/卸載 | 允許 | data (URI) |
| ACTION_PACKAGE_ADDED/REMOVED/REPLACED | 應用安裝/移除/更新 | 允許 | data (package:...), EXTRA_UID, EXTRA_REPLACING |
Android 8.0 限制應用在 Manifest 中靜態註冊隱式廣播 (無明確指定目標套件/元件的廣播)。例外清單:
// 發送有序廣播 (有序執行,可攔截、修改、中止)
Intent intent = new Intent("com.example.CUSTOM_ACTION");
intent.putExtra("data", "custom data");
sendOrderedBroadcast(intent, Manifest.permission.MY_CUSTOM_PERMISSION,
new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
// 最終接收者,可獲取結果
Log.d("CustomBroadcast", "Final result: " + getResultData());
}
}, null, Activity.RESULT_OK, "initial data", null);
// 發送黏性廣播 (已棄用 API 21+,改用持久化儲存)
// sendStickyBroadcast(intent);
// 本地廣播 (進程內,效能高、安全) - LocalBroadcastManager 已棄用,建議用 LiveData/Flow/EventBus
// LocalBroadcastManager.getInstance(context).sendBroadcast(localIntent);
android.permission.SEND_SMS)onReceive 中檢查 intent.getAction()、intent.getPackage()、權限Android 廣播機制強大但需注意版本限制。核心原則:
ConnectivityManager.NetworkCallback、BatteryManager、PowerManager 現代 APILiveData、Flow、EventBus