Android BroadcastReceiver 學習

 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方法，並在該方法中響應事件。 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。
  <receiver android:name=".SMSReceiver">
        <intent-filter>
                <action android:name="android.provider.Telephony.SMS_RECEIVED" />
        </intent-filter>
</receiver>
   2. 動態方式, 在activity裡面調用函數來注冊，和靜態的內容差不多。一個形參是receiver，另一個是IntentFilter，其中裡面是要接收的action。
  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: <uses-permission android:name="android.permission.RECEIVE_SMS" />

下面給出動態注冊的接收來電的廣播處理的CallReceiver的代碼：
     一種方式是直接讀取intent.getStringExtra("incoming_number")來獲取來電號碼：
  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來監聽狀態的變化： 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次。
      監聽通話狀態需要加上權限： <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 去處理。