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 去處理。