2025-05-17

BroadcastReceiver 用於異步接收廣播Intent。主要有兩大類,用於接收廣播的:
正常廣播 Normal broadcasts(用 Context.sendBroadcast()發送)是完全異步的。它們都運行在一個未定義的順序,通常是在同一時間。這樣會更有效,但意味著receiver不能包含所要使用的結果或中止的API。  
有序廣播 Ordered broadcasts(用 Context.sendOrderedBroadcast()發送)每次被發送到一個receiver。所謂有序,就是每個receiver執行後可以傳播到下一個receiver,也可以完全中止傳播——不傳播給其他receiver。 而receiver運行的順序可以通過matched intent-filter 裡面的android:priority來控制,當priority優先級相同的時候,Receiver以任意的順序運行。

    要註意的是,即使是Normal broadcasts,系統在某些情況下可能會恢復到一次傳播給一個receiver。 特別是receiver可能需要創建一個進程,為瞭避免系統超載,隻能一次運行一個receiver。

    Broadcast Receiver 並沒有提供可視化的界面來顯示廣播信息。可以使用Notification和Notification Manager來實現可視化的信息的界面,顯示廣播信息的內容,圖標及震動信息。

生命周期
    一個BroadcastReceiver 對象隻有在被調用onReceive(Context, Intent)的才有效的,當從該函數返回後,該對象就無效的瞭,結束生命周期。
    因此從這個特征可以看出,在所調用的onReceive(Context, Intent)函數裡,不能有過於耗時的操作,不能使用線程來執行。對於耗時的操作,請start service來完成。因為當得到其他異步操作所返回的結果時,BroadcastReceiver 可能已經無效瞭。

發送廣播
    事件的廣播比較簡單,構建Intent對象,可調用sendBroadcast(Intent)方法將廣播發出。另外還有sendOrderedBroadcast(),sendStickyBroadcast()等方法,請查閱API Doc。
    1.new Intent with action name
        Intent intent = new Intent(String action);
      或者 隻是new Intent, 然後
        intent.setAction(String action);

    2.set data等準備好瞭後,in activity,
        sendBroadcast(Intent); // 發送廣播

接收廣播
    通過定義一個繼承BroadcastReceiver類來實現,繼承該類後覆蓋其onReceiver方法,並在該方法中響應事件。
[java] public class SMSReceiver extends BroadcastReceiver {  
 
        @Override  
        public void onReceive(Context context, Intent intent) {  
                // get data from SMS intent   
                Bundle bundle = intent.getExtras();  
                if (bundle != null){  
                        // get message by "pdus"   
                        Object[] objArray = (Object[]) bundle.get("pdus");  
 
                        // rebuild SMS   
                        SmsMessage[] messages = new SmsMessage[objArray.length];  
                        for (int i=0; i < objArray.length; i++){  
                                messages[i] = SmsMessage.createFromPdu((byte[])objArray[i]);  
 
                                StringBuilder str = new StringBuilder("from: ");  
                                str.append(messages[i].getDisplayOriginatingAddress());  
                                str.append("\nmessage:\n");  
                                str.append(messages[i].getDisplayMessageBody());  
 
                                Toast.makeText(context, str.toString(), Toast.LENGTH_LONG)  
                                                .show();  
                        }  
                }  
        }  

public class SMSReceiver extends BroadcastReceiver {

        @Override
        public void onReceive(Context context, Intent intent) {
                // get data from SMS intent
                Bundle bundle = intent.getExtras();
                if (bundle != null){
                        // get message by "pdus"
                        Object[] objArray = (Object[]) bundle.get("pdus");

                        // rebuild SMS
                        SmsMessage[] messages = new SmsMessage[objArray.length];
                        for (int i=0; i < objArray.length; i++){
                                messages[i] = SmsMessage.createFromPdu((byte[])objArray[i]);

                                StringBuilder str = new StringBuilder("from: ");
                                str.append(messages[i].getDisplayOriginatingAddress());
                                str.append("\nmessage:\n");
                                str.append(messages[i].getDisplayMessageBody());

                                Toast.makeText(context, str.toString(), Toast.LENGTH_LONG)
                                                .show();
                        }
                }
        }
}

註冊Receiver

   註冊有兩種方式:
   1. 靜態方式,在AndroidManifest.xml的application裡面定義receiver並設置要接收的action。
[html] <receiver android:name=".SMSReceiver">  
        <intent-filter>  
                <action android:name="android.provider.Telephony.SMS_RECEIVED" />  
        </intent-filter>  
</receiver> 
<receiver android:name=".SMSReceiver">
        <intent-filter>
                <action android:name="android.provider.Telephony.SMS_RECEIVED" />
        </intent-filter>
</receiver>

 2. 動態方式, 在activity裡面調用函數來註冊,和靜態的內容差不多。一個形參是receiver,另一個是IntentFilter,其中裡面是要接收的action。
[java] public class HelloDemo extends Activity {     
        private BroadcastReceiver receiver;     
 
        @Override  
        protected void onStart() {  
                super.onStart();  
 
                receiver = new CallReceiver();  
                registerReceiver(receiver, new IntentFilter("android.intent.action.PHONE_STATE"));  
        }  
 
        @Override  
        protected void onStop() {  
                unregisterReceiver(receiver);  
                super.onStop();  
        }  

public class HelloDemo extends Activity {   
        private BroadcastReceiver receiver;   

        @Override
        protected void onStart() {
                super.onStart();

                receiver = new CallReceiver();
                registerReceiver(receiver, new IntentFilter("android.intent.action.PHONE_STATE"));
        }

        @Override
        protected void onStop() {
                unregisterReceiver(receiver);
                super.onStop();
        }
}

 一個receiver可以接收多個action的,即可以有多個intent-filter,需要在onReceive裡面對intent.getAction(action name)進行判斷。
 
    個人推薦使用靜態註冊方式,由系統來管理receiver,而且程序裡的所有receiver,可以在xml裡面一目瞭然。而動態註冊方式,隱藏在代碼中,比較難發現。
    而且動態註冊,需要特別註意的是,在退出程序前要記得調用Context.unregisterReceiver()方法。一般在activity的onStart()裡面進行註冊, onStop()裡面進行註銷。官方提醒,如果在Activity.onResume()裡面註冊瞭,就必須在Activity.onPause()註銷。

 

Permission權限
  要接收某些action,需要在AndroidManifest.xml裡面添加相應的permission。例如接收SMS:[html] <uses-permission android:name="android.permission.RECEIVE_SMS" /> 
<uses-permission android:name="android.permission.RECEIVE_SMS" />
下面給出動態註冊的接收來電的廣播處理的CallReceiver的代碼:

   一種方式是直接讀取intent.getStringExtra("incoming_number")來獲取來電號碼:
[java] public class CallReceiver extends BroadcastReceiver {  
 
        @Override  
        public void onReceive(Context context, Intent intent) {  
                TelephonyManager teleManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);  
                  
                switch(teleManager.getCallState()){  
                case TelephonyManager.CALL_STATE_RINGING: //響鈴   
                        Toast.makeText(context, "Ringing: " + intent.getStringExtra("incoming_number"), Toast.LENGTH_LONG).show();  
                        break;  
                case TelephonyManager.CALL_STATE_OFFHOOK: //接聽   
                        Toast.makeText(context, "OffHook: " + intent.getStringExtra("incoming_number"), Toast.LENGTH_LONG).show();  
                        break;  
                case TelephonyManager.CALL_STATE_IDLE: //掛斷 www.aiwalls.com   
                        Toast.makeText(m_context, "Idle: " + incomingNumber, Toast.LENGTH_LONG).show();  
                        break;  
                }  
        }  

public class CallReceiver extends BroadcastReceiver {

        @Override
        public void onReceive(Context context, Intent intent) {
                TelephonyManager teleManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
                
                switch(teleManager.getCallState()){
                case TelephonyManager.CALL_STATE_RINGING: //響鈴
                        Toast.makeText(context, "Ringing: " + intent.getStringExtra("incoming_number"), Toast.LENGTH_LONG).show();
                        break;
                case TelephonyManager.CALL_STATE_OFFHOOK: //接聽
                        Toast.makeText(context, "OffHook: " + intent.getStringExtra("incoming_number"), Toast.LENGTH_LONG).show();
                        break;
                case TelephonyManager.CALL_STATE_IDLE: //掛斷
                        Toast.makeText(m_context, "Idle: " + incomingNumber, Toast.LENGTH_LONG).show();
                        break;
                }
        }
}

在運行時,發現除瞭響鈴時可以獲取來電號碼,接聽和掛斷都不能成功獲取的,顯示為null。

   另一種方式是通過PhoneStateListener的onCallStateChanged來監聽狀態的變化:[java] public class CallReceiver extends BroadcastReceiver {  
 
        private Context m_context;  
        @Override  
        public void onReceive(Context context, Intent intent) {  
                m_context = context;  
                TelephonyManager teleManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);  
                teleManager.listen(new PhoneStateListener(){  
 
                        @Override  
                        public void onCallStateChanged(int state, String incomingNumber) {  
                                switch(state){  
                                case TelephonyManager.CALL_STATE_RINGING: //響鈴   
                                        Toast.makeText(m_context, "Ringing: " + incomingNumber, Toast.LENGTH_LONG)  
                                                                .show();  
                                        break;  
                                case TelephonyManager.CALL_STATE_OFFHOOK: //接聽   
                                        Toast.makeText(m_context, "OffHook: " + incomingNumber, Toast.LENGTH_LONG)  
                                        .show();  
                                        break;  
                                case TelephonyManager.CALL_STATE_IDLE: //掛斷   
                                        Toast.makeText(m_context, "Idle: " + incomingNumber, Toast.LENGTH_LONG)  
                                        .show();  
                                        break;  
                                }  
                        }}, PhoneStateListener.LISTEN_CALL_STATE);   
        }  

public class CallReceiver extends BroadcastReceiver {

        private Context m_context;
        @Override
        public void onReceive(Context context, Intent intent) {
                m_context = context;
                TelephonyManager teleManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
                teleManager.listen(new PhoneStateListener(){

                        @Override
                        public void onCallStateChanged(int state, String incomingNumber) {
                                switch(state){
                                case TelephonyManager.CALL_STATE_RINGING: //響鈴
                                        Toast.makeText(m_context, "Ringing: " + incomingNumber, Toast.LENGTH_LONG)
                                                                .show();
                                        break;
                                case TelephonyManager.CALL_STATE_OFFHOOK: //接聽
                                        Toast.makeText(m_context, "OffHook: " + incomingNumber, Toast.LENGTH_LONG)
                                        .show();
                                        break;
                                case TelephonyManager.CALL_STATE_IDLE: //掛斷
                                        Toast.makeText(m_context, "Idle: " + incomingNumber, Toast.LENGTH_LONG)
                                        .show();
                                        break;
                                }
                        }}, PhoneStateListener.LISTEN_CALL_STATE); 
        }
}

  運行時也發現incomingNumber在接聽和掛斷時獲取為blank。

    因為這裡監聽的是通話的狀態變化,所以這個receiver會被調用3次。

    監聽通話狀態需要加上權限:[html] <uses-permission android:name="android.permission.READ_PHONE_STATE"/> 
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
 
小結:
1. 對於sendBroadCast的intent對象,需要設置其action name;
2. 推薦使用顯式指明receiver,在配置文件AndroidManifest.xml指明;
3. 一個receiver可以接收多個action;
4. 每次接收廣播都會重新生成一個接收廣播的對象,再次調用onReceive;
5. 在BroadCast 中盡量不要處理太多邏輯問題,建議復雜的邏輯交給Activity 或者 Service 去處理。

摘自  agods–足跡

 

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *