Android Service 服務（二）—— BroadcastReceiver

lostinai發表於2013-05-21
AndroidAST

一、 BroadcastReceiver簡介

BroadcastReceiver，用於非同步接收廣播Intent，廣播Intent是通過呼叫Context.sendBroadcast()傳送、BroadcastReceiver()接收。

廣播Intent的傳送是通過呼叫Context.sendBroadcast()、Context.sendOrderedBroadcast()、Context.sendStickyBroadcast()來實現的。通常一個廣播Intent可以被訂閱了此Intent的多個廣播接收者所接收，廣播接收者和JMS中的Topic訊息接收者很相似。
廣播接收器只能接收廣播，對廣播的通知做出反應，很多廣播都產生於系統程式碼，如：時區改變的通知、電池電量不足、使用者改變了語言偏好，或者開機啟動等
廣播接收器沒有使用者介面，但是它可以為它們接收到資訊啟動一個Activity或者使用NotificationManager來通知使用者.


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


二、 BroadcastReceiver註冊方式

1 靜態註冊
AndroidManifest.xml中，application裡面，定義receiver並設定要接收的action
[java] view plaincopyprint?
  1. <receiver android:name=".receiver.MusicReceiver" >  
  2.     <intent-filter>  
  3.         <action android:name="com.homer.receiver.musicReceiver" />  
  4.     </intent-filter>  
  5. </receiver>  

2 動態註冊
Activity中，需在onStart()中呼叫registerReceiver()進行註冊和在onStop中呼叫unregisterReceiver()釋放服務
[java] view plaincopyprint?
  1. private MusicReceiver receiver;  
  2.   
  3. @Override  
  4. protected void onStart(){  
  5.     super.onStart();  
  6.       
  7.     receiver = new MusicReceiver();  
  8.     IntentFilter filter = new IntentFilter();  
  9.     filter.addAction("com.homer.receiver.musicReceiver");  
  10.     this.registerReceiver(receiver, filter);  
  11. }  
  12.   
  13. @Override  
  14. protected void onStop(){  
  15.     this.unregisterReceiver(receiver);  
  16.       
  17.     super.onStop();  
  18. }  

3 兩種註冊方式的比較
靜態註冊方式，由系統來管理receiver，而且程式裡的所有receiver，可以在xml裡面一目瞭然
動態註冊方式，隱藏在程式碼中，比較難發現；需要特別注意的是，在退出程式前要記得呼叫Context.unregisterReceiver()方法。一般在activity的onStart()裡面進行註冊, onStop()裡面進行登出。官方提醒，如果在Activity.onResume()裡面註冊了，就必須在Activity.onPause()登出。


三、 BroadcastReceiver生命週期

一個BroadcastReceiver 物件只有在被呼叫onReceive(Context, Intent)的才有效，當從該函式返回後，該物件就無效的了，結束生命週期。
因此從這個特徵可以看出，在所呼叫的onReceive(Context, Intent)函式裡，不能有過於耗時的操作，不能使用執行緒來執行。對於耗時的操作，應該在startService中來完成。因為當得到其他非同步操作所返回的結果時，BroadcastReceiver 可能已經無效了。


四、 BroadcastReceiver示例

Activity

[java] view plaincopyprint?
  1. public class PlayMusicRecevicer extends Activity implements OnClickListener {  
  2.       
  3.     private Button playBtn;  
  4.     private Button stopBtn;  
  5.     private Button pauseBtn;  
  6.     private Button exitBtn;  
  7.     private Button closeBtn;  
  8.       
  9.     private Intent intent;  
  10.       
  11.     @Override  
  12.     public void onCreate(Bundle savedInstanceState) {  
  13.         super.onCreate(savedInstanceState);  
  14.         setContentView(R.layout.music_receiver);  
  15.   
  16.         playBtn = (Button) findViewById(R.id.play);  
  17.         stopBtn = (Button) findViewById(R.id.stop);  
  18.         pauseBtn = (Button) findViewById(R.id.pause);  
  19.         exitBtn = (Button) findViewById(R.id.exit);  
  20.         closeBtn = (Button) findViewById(R.id.close);  
  21.           
  22.         playBtn.setOnClickListener(this);  
  23.         stopBtn.setOnClickListener(this);  
  24.         pauseBtn.setOnClickListener(this);  
  25.         exitBtn.setOnClickListener(this);  
  26.         closeBtn.setOnClickListener(this);  
  27.   
  28.     }  
  29.   
  30.     @Override  
  31.     public void onClick(View v) {  
  32.         int op = -1;  
  33.          intent = new Intent("com.homer.receiver.musicReceiver");  
  34.   
  35.         switch (v.getId()) {  
  36.         case R.id.play:                             // play music  
  37.             op = 1;  
  38.             break;  
  39.         case R.id.stop:                             // stop music  
  40.             op = 2;  
  41.             break;  
  42.         case R.id.pause:                            // pause music  
  43.             op = 3;  
  44.             break;  
  45.         case R.id.close:                            // close activity  
  46.             this.finish();  
  47.             break;  
  48.         case R.id.exit:                             // process by MusicReceiver  
  49.             op = 4;  
  50.             this.finish();  
  51.             break;  
  52.         }  
  53.   
  54.         Bundle bundle = new Bundle();  
  55.         bundle.putInt("op", op);  
  56.         intent.putExtras(bundle);  
  57.   
  58.          sendBroadcast(intent);                     // sendBroadcast  
  59.     }  
  60.   
  61. //  private MusicReceiver receiver;  
  62. //    
  63. //  @Override  
  64. //  protected void onStart(){  
  65. //      super.onStart();  
  66. //        
  67. //      receiver = new MusicReceiver();  
  68. //      IntentFilter filter = new IntentFilter();  
  69. //      filter.addAction("com.homer.receiver.musicReceiver");  
  70. //      this.registerReceiver(receiver, filter);  
  71. //  }  
  72. //    
  73. //  @Override  
  74. //  protected void onStop(){  
  75. //      this.unregisterReceiver(receiver);  
  76. //        
  77. //      super.onStop();  
  78. //  }  
  79.       
  80.     @Override  
  81.     public void onDestroy(){  
  82.         super.onDestroy();  
  83.           
  84.         if(intent != null){  
  85.             stopService(intent);  
  86.         }  
  87.     }  
  88. }  


BroadcastReceiver

[java] view plaincopyprint?
  1. public class MusicReceiver extends BroadcastReceiver {      // receive Broadcast  
  2.       
  3.     @Override  
  4.     public void onReceive(Context context, Intent intent) {  
  5.           
  6.         if(intent != null){  
  7.             Bundle bundle = intent.getExtras();  
  8.             Intent it = new Intent(context, MusicReceiverService.class);    // call service for MusicReceiverService.class  
  9.             it.putExtras(bundle);  
  10.             if(bundle != null){  
  11.                 int op = bundle.getInt("op");  
  12.                 if(op == 4){  
  13.                     context.stopService(it);        // stopService  
  14.                 }else{  
  15.                     context.startService(it);       // startService  
  16.                 }  
  17.             }  
  18.         }  
  19.     }  
  20. }  

Service（BroadcastReceiver呼叫的後臺服務）

[java] view plaincopyprint?
  1. public class MusicReceiverService extends Service {  
  2.       
  3.     private MediaPlayer mediaPlayer;  
  4.   
  5.     @Override  
  6.     public IBinder onBind(Intent arg0) {  
  7.         return null;  
  8.     }  
  9.   
  10.     @Override  
  11.     public void onCreate() {  
  12.         Toast.makeText(this, "show media player", Toast.LENGTH_SHORT).show();  
  13.   
  14.         if (mediaPlayer == null) {  
  15.             mediaPlayer = MediaPlayer.create(this, R.raw.tmp);  
  16.             mediaPlayer.setLooping(false);  
  17.         }  
  18.     }  
  19.   
  20.     @Override  
  21.     public void onDestroy() {  
  22.         Toast.makeText(this, "stop media player", Toast.LENGTH_SHORT);  
  23.         if (mediaPlayer != null) {  
  24.             mediaPlayer.stop();  
  25.             mediaPlayer.release();  
  26.         }  
  27.     }  
  28.   
  29.     @Override  
  30.     public void onStart(Intent intent, int startId) {  
  31.         if (intent != null) {  
  32.             Bundle bundle = intent.getExtras();  
  33.             if (bundle != null) {  
  34.                 int op = bundle.getInt("op");  
  35.                 switch (op) {  
  36.                 case 1:  
  37.                     play();  
  38.                     break;  
  39.                 case 2:  
  40.                     stop();  
  41.                     break;  
  42.                 case 3:  
  43.                     pause();  
  44.                     break;  
  45.                 }  
  46.             }  
  47.         }  
  48.     }  
  49.   
  50.     public void play() {  
  51.         if (!mediaPlayer.isPlaying()) {  
  52.             mediaPlayer.start();  
  53.         }  
  54.     }  
  55.   
  56.     public void pause() {  
  57.         if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
  58.             mediaPlayer.pause();  
  59.         }  
  60.     }  
  61.   
  62.     public void stop() {  
  63.         if (mediaPlayer != null) {  
  64.             mediaPlayer.stop();  
  65.             try {  
  66.                 mediaPlayer.prepare();  // 在呼叫stop後如果需要再次通過start進行播放,需要之前呼叫prepare函式  
  67.             } catch (IOException ex) {  
  68.                 ex.printStackTrace();  
  69.             }  
  70.         }  
  71.     }  
  72. }  

AndroidManifest.xml
[css] view plaincopyprint?
  1. <service  
  2.     android:name=".receiver.MusicReceiverService"  
  3.     android:enabled="true" >  
  4.     <intent-filter>  
  5.         <action android:name="com.homer.service.musicReceiverService" />  
  6.     </intent-filter>  
  7. </service>   
  8. <receiver android:name=".receiver.MusicReceiver" >  
  9.     <intent-filter>  
  10.         <action android:name="com.homer.receiver.musicReceiver" />  
  11.     </intent-filter>  
  12. </receiver>  


五、程式碼解析

1、Activity中，PlayMusicService中通過重寫OnClickListener 介面onClick()方法實現對播放音樂的控制，把音樂各種操作用數字通過Intent傳遞給service

然後通過構造一個Intent ， intent = new Intent("com.homer.receiver.musicReceiver"); 

其中，com.homer.receiver.musicReceiver是 AndroidManifest.xml 對receiver的定義（或動態註冊addAction為filter.addAction("com.homer.receiver.musicReceiver");）

2、Activity中，音樂播放的控制，利用Bundle繫結數字op後，通過 sendBroadcast(intent); 廣播出去
Bundle bundle = new Bundle();
bundle.putInt("op", op);
intent.putExtras(bundle);

startService(intent);

3、 BroadcastReceiver中，會處理Activity啟動的 sendBroadcast(intent); 廣播，通過實現onReceive()方法，解析Activity中Intent的Bundle資料。

然後通過Intent it = new Intent(context, MusicReceiverService.class); 初始化一個啟動Service服務的Intent

最後根據解析bundle的op數值決定啟動context.startService(it); 服務 或 關閉context.stopService(it); 服務

4、Service中，處理BroadcastReceiver廣播啟動的MusicReceiverService服務，即依次呼叫service的啟動過程：onCreate --> onStart(可多次呼叫) --> onDestroy

onCreate()，  建立mediaPlayer

onStart()，      通過獲取Bundle bundle = intent.getExtras();，提取int op = bundle.getInt("op");，然後執行響應的音樂播放操作

onDestroy()，停止並釋放mediaPlayer音樂資源，如果當執行context.stopService()時呼叫此方法

5、Activity中，onClick()函式中close與exit是執行含義是不同的：

close ： 只是執行了this.finish(); 關閉了本Activity窗體，service並沒有被關掉，音樂依然會繼續在後臺播放

exit  ： 先呼叫了stopService(intent); 關閉了service服務，在Service中會呼叫3中的onDestroy()停止並釋放音樂資源，後才執行this.finish(); 關閉了本Activity窗體


六、BroadcastReceiver總結

BroadcastReceiver需要先註冊receriver（靜態或動態）—> 傳送廣播sendBroadcast(intent) —> 處理廣播onReceive(Context context, Intent intent) —> 啟動服務startService(it) —> 關閉服務stopService(it) 

其中，receriver兩種註冊方式，靜態註冊在AndroidManifest.xml中的receiver和動態註冊在PlayMusicRecevicer註釋的程式碼部分，兩者選擇一種即可


程式碼下載



參考推薦：

Android Service生命週期及用法

Android之BroadcastReceiver的使用（靜態和動態兩種註冊方式）

相關文章