BroadcastReceiver 核心特性
- 系統級監聽器:獨立進程,App 退出仍可被喚醒。
- 生命週期極短:
onReceive() 執行完即銷毀,**嚴禁耗時操作** (10 秒內完成,否則 ANR)。
- 不適用開啟子執行緒:進程可能在子執行緒結束前被殺,改用
goAsync() (延長至 30s) 或啟動 Service/WorkManager。
兩種註冊方式
| 方式 | 靜態註冊 (Manifest) | 動態註冊 (代碼) |
| 聲明位置 | <receiver> 在 <application> 內 | Context.registerReceiver() |
| 生效時機 | 安裝後即時生效,無需啟動 App | 僅在註冊代碼執行後生效 (通常在 Activity/Service onCreate) |
| 取消註冊 | 自動 (應用被卸載/停用) | 必須手動 unregisterReceiver() (onDestroy) |
| 優先級控制 | android:priority="-1000~1000" | IntentFilter.setPriority() |
| 適用場景 | 開機啟動、網絡變化、短信/電話攔截、系統事件 | 頁面內部通訊、臨時監聽、依賴運行時狀態 |
靜態註冊範例
<receiver android:name=".BasicBroadcast"
android:enabled="true"
android:exported="false"> <!-- true 允許其他應用發送 -->
<intent-filter android:priority="100">
<action android:name="cn.bgxt.Broadcastdemo.Basic.broadcast" />
</intent-filter>
</receiver>
動態註冊範例
private BasicBroadcast receiver = new BasicBroadcast();
private IntentFilter filter = new IntentFilter("cn.bgxt.Broadcastdemo.Basic.broadcast");
@Override protected void onResume() {
super.onResume();
registerReceiver(receiver, filter);
}
@Override protected void onPause() {
super.onPause();
unregisterReceiver(receiver); // 必須成對調用,否則洩漏
}
廣播類型:普通 vs 有序
| 類型 | 發送 API | 傳遞機制 | 特點 |
| 普通廣播 | sendBroadcast(intent) | **異步並行**,所有接收器同時收到 | 效率高,接收器間無順序、無法攔截 |
| 有序廣播 | sendOrderedBroadcast(intent, permission) | **同步串行**,按 priority 高→低依次傳遞 | 高優先級可修改資料、abortBroadcast() 終止傳播 |
※ 系統內建廣播 (短信、電話、開機) **均為有序廣播**,故可被攔截器攔截。
發送廣播範例
// 普通廣播
Intent broadcast = new Intent("com.example.MY_ACTION");
broadcast.putExtra("msg", "Hello");
sendBroadcast(broadcast);
// 有序廣播 (帶權限控制)
sendOrderedBroadcast(broadcast, "com.example.PERM_RECEIVE"); // 接收端需聲明同權限
實戰一:關鍵字攔截短信 (有序廣播 + abortBroadcast)
權限
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_SMS" /> <!-- Android 4.4+ 讀取短信內容需此權限 -->
Receiver 代碼
public class SmsFilterReceiver extends BroadcastReceiver {
private static final String[] BLACK_KEYWORDS = {"保險", "推銷", "貸款", "中獎"};
@Override public void onReceive(Context context, Intent intent) {
if (!Telephony.Sms.Intents.SMS_RECEIVED_ACTION.equals(intent.getAction())) return;
Bundle bundle = intent.getExtras();
if (bundle == null) return;
Object[] pdus = (Object[]) bundle.get("pdus");
if (pdus == null) return;
for (Object pdu : pdus) {
SmsMessage msg = SmsMessage.createFromPdu((byte[]) pdu);
String body = msg.getMessageBody();
for (String kw : BLACK_KEYWORDS) {
if (body.contains(kw)) {
// 攔截:顯示 Toast、記錄日誌、abortBroadcast 終止傳播
Toast.makeText(context, "攔截垃圾短信:" + body, Toast.LENGTH_LONG).show();
abortBroadcast(); // 關鍵:阻止系統 Messaging App 收到
break;
}
}
}
}
}
Manifest 註冊 (高優先級)
<receiver android:name=".SmsFilterReceiver"
android:exported="true"
android:permission="android.permission.BROADCAST_SMS"> <!-- 系統發送短信廣播帶此權限 -->
<intent-filter android:priority="999"> <!-- 極高優先級,早於系統 App -->
<action android:name="android.provider.Telephony.SMS_RECEIVED" />
</intent-filter>
</receiver>
實戰二:IP 撥號前綴自動添加 (有序廣播 + 修改結果數據)
public class IpDialerReceiver extends BroadcastReceiver {
private static final String IP_PREFIX = "17951";
@Override public void onReceive(Context context, Intent intent) {
String originalNumber = getResultData(); // 獲取上一個接收器設定的號碼 (或原始號碼)
if (originalNumber == null || originalNumber.startsWith(IP_PREFIX)) return;
String newNumber = IP_PREFIX + originalNumber;
setResultData(newNumber); // 修改結果數據,傳遞給下一個接收器 (最終由系統撥號)
Log.d("IpDialer", "加前綴: " + newNumber);
}
}
<receiver android:name=".IpDialerReceiver">
<intent-filter android:priority="100">
<action android:name="android.intent.action.NEW_OUTGOING_CALL" />
</intent-filter>
</receiver>
<uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" />
Android 8.0+ (API 26) 靜態註冊限制與對策
- **隱式廣播** (無指定 Package/Component) **不能在 Manifest 靜態註冊** (除少數白名單:開機、時區、語言、數據連接等)。
- 對策:
li>改用動態註冊 (Activity/Service 生命週期內)。
- 使用
JobScheduler / WorkManager 監聽系統事件 (如充電、網絡)。
- 針對白名單廣播 (如
BOOT_COMPLETED) 仍可靜態註冊。
最佳實踐總結
- 優先使用 **動態註冊** 或 **Jetpack 組件** (LiveData, Flow, WorkManager) 替代隱式廣播。
- 靜態註冊僅用於**白名單系統廣播**或**跨應用顯式廣播**。
- 有序廣播攔截務必
abortBroadcast() 並設高 priority。
onReceive 保持極簡,耗時任務轉交 Service / WorkManager。
- 導出組件 (
exported=true) 必須聲明 permission 保護。