萬盛學電腦網

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

Android BroadcastReceiver 完整指南:註冊方式、有序/普通廣播、攔截系統廣播實戰

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 生命週期內)。
    1. 使用 JobScheduler / WorkManager 監聽系統事件 (如充電、網絡)。
    2. 針對白名單廣播 (如 BOOT_COMPLETED) 仍可靜態註冊。

最佳實踐總結

  1. 優先使用 **動態註冊** 或 **Jetpack 組件** (LiveData, Flow, WorkManager) 替代隱式廣播。
  2. 靜態註冊僅用於**白名單系統廣播**或**跨應用顯式廣播**。
  3. 有序廣播攔截務必 abortBroadcast() 並設高 priority。
  4. onReceive 保持極簡,耗時任務轉交 Service / WorkManager。
  5. 導出組件 (exported=true) 必須聲明 permission 保護。
copyright © 萬盛學電腦網 all rights reserved