简介
Broadcast Receiver用于接收并处理广播通知(broadcastannouncements)。
多数的广播是系统发起的,如地域变换、电量不足、来电来信等。
程序可以有任意数量的Broadcast Receivers来响应它觉得重要的通知。
Broadcast Receiver可以通过多种方式通知用户:启动activity、使用NotificationManager、开启背景灯、振动设备、播放声音等,最典型的是在状态栏显示一个图标,这样用户就可以点它打开看通知内容。
通常我们的某个应用或系统本身在某些事件(电池电量不足、来电来短信)来临时会广播一个Intent出去,我们可以利用注册一个Broadcast Receiver来监听到这些Intent并获取Intent中的数据。
在程序中接受系统发的广播
我们举一个例子说明,一个接受系统Date改变的广播的例子。
先新建一个HelloBroadcastReceiver.java类,继承自BroadcastReceiver并复写它的onReceive方法。这样就创建了一个专门用来接收广播的类。
package com.tianjf;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
public class HelloBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Log.d("debug", "Date has been changed!");
Log.d("debug", ""+intent.getAction());
}
}
但是上面的Broadcast Receiver没有指定接收哪个广播,我们要指定某个Receiver接收哪个广播,必须在AndroidManifest.xml中注册此Receiver
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.tianjf"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk android:minSdkVersion="4" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name" >
<activity
android:name=".BroadcastDemoActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 定义Broadcast Receiver指定监听的Action(系统Date改变action) -->
<receiver android:name="HelloBroadcastReceiver" >
<intent-filter>
<action android:name="android.intent.action.DATE_CHANGED" />
</intent-filter>
</receiver>
</application>
</manifest>
OK,运行之后,更改系统Date看看,果然打印了两行Log。(着两行Log有时候打得出来,有时候打不出来,不知道神马原因)
接收自己发的广播
直接上代码
BroadcastDemoActivity.java
package com.tianjf;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
public class BroadcastDemoActivity extends Activity implements OnClickListener {
private Button button;
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
button = (Button) findViewById(R.id.button);
button.setOnClickListener(this);
}
@Override
public void onClick(View v) {
// 定义一个intent
Intent intent = new Intent();
intent.setAction("MY_BROADCAST_ACTION");
intent.putExtra("yaoyao",
"yaoyao is 189 days old ,27 weeks -- 2010-08-10");
// 广播出去
sendBroadcast(intent);
}
}
HelloBroadcastReceiver.java
package com.tianjf;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
public class HelloBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Log.d("debug", "" + intent.getAction());
if (intent.getAction().equals("android.intent.action.DATE_CHANGED")) {
Log.d("debug", "Date has been changed!");
Log.d("debug", "" + intent.getAction());
} else if (intent.getAction().equals("MY_BROADCAST_ACTION")) {
Log.d("debug", "Say Hello to Yaoyao!");
Log.d("debug", intent.getStringExtra("yaoyao"));
}
}
}
AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.tianjf"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk android:minSdkVersion="4" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name" >
<activity
android:name=".BroadcastDemoActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 定义Broadcast Receiver指定监听的Action(系统Date改变action和自动义的广播) -->
<receiver android:name="HelloBroadcastReceiver" >
<intent-filter>
<action android:name="MY_BROADCAST_ACTION" />
<action android:name="android.intent.action.DATE_CHANGED" />
</intent-filter>
</receiver>
</application>
</manifest>
注册广播的2种方式
BroadcastReceiver在没有注册广播地址之前是使用不了的。没有注册广播地址的BroadcastReceiver就像一个缺少选台按钮的收音机,虽然功能俱备,但也无法收到电台的信号。有两种注册方法:
静态注册。在AndroidManifest.xml文件中配置(上文两个例子已经介绍了)
动态注册。要在代码中动态的指定广播地址并注册,通常我们是在Activity或Service注册一个广播
静态注册的方法参照以上两个例子。
至于动态注册的方法,我们看以下例子:
将以上的BroadcastDemoActivity做如下修改
package com.tianjf;
import android.app.Activity;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
public class BroadcastDemoActivity extends Activity implements OnClickListener {
private Button button;
HelloBroadcastReceiver receiver;
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
button = (Button) findViewById(R.id.button);
button.setOnClickListener(this);
receiver = new HelloBroadcastReceiver();
IntentFilter filter = new IntentFilter();
filter.addAction("android.intent.action.DATE_CHANGED");
filter.addAction("MY_BROADCAST_ACTION");
registerReceiver(receiver, filter);
}
@Override
public void onClick(View v) {
// 定义一个intent
Intent intent = new Intent();
intent.setAction("MY_BROADCAST_ACTION");
intent.putExtra("yaoyao",
"yaoyao is 189 days old ,27 weeks -- 2010-08-10");
// 广播出去
sendBroadcast(intent);
}
@Override
protected void onDestroy() {
super.onDestroy();
unregisterReceiver(receiver);
}
}
注意:动态注册广播的方法必须在onDestory方法里面注销,如果不注销的话,系统会报一个异常(如下)
12-19 07:16:04.186: E/ActivityThread(23244): Activity com.tianjf.BroadcastDemoActivity has leaked IntentReceiver com.tianjf.HelloBroadcastReceiver@40cef150 that was originally registered here. Are you missing a call to unregisterReceiver()?
异常也提示了要注销广播。
两种广播注册方式的区别:
静态注册的方法,不管应用处于什么状态,甚至于退出应用,都能接收广播并作相应的处理。当然,相对来说是比较耗电的
动态注册的方法,因为动态注册必须要注销广播,所以,应用退出也就不接收广播了。所以是省电的
有序广播(Ordered Broadcast)
有序广播比较特殊,它每次只发送到优先级较高的接收者那里,然后由优先级高的接受者再传播到优先级低的接收者那里,优先级高的接收者有能力终止这个广播
为了演示有序广播的流程,我们创建三个接收者的代码,如下:
package com.tianjf;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
public class FirstBroadcastReceiver extends BroadcastReceiver {
private static final String TAG = "TestOrderdBroadcastReceiver";
@Override
public void onReceive(Context context, Intent intent) {
String msg = intent.getStringExtra("msg");
Log.i(TAG, "FirstBroadcastReceiver: " + msg);
Bundle bundle = new Bundle();
bundle.putString("msg", msg + "@FirstBroadcastReceiver");
setResultExtras(bundle);
}
}
package com.tianjf;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
public class SecondBroadcastReceiver extends BroadcastReceiver {
private static final String TAG = "TestOrderdBroadcastReceiver";
@Override
public void onReceive(Context context, Intent intent) {
String msg = getResultExtras(true).getString("msg");
Log.i(TAG, "SecondBroadcastReceiver: " + msg);
Bundle bundle = new Bundle();
bundle.putString("msg", msg + "@SecondBroadcastReceiver");
setResultExtras(bundle);
}
}
package com.tianjf;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
public class ThirdBroadcastReceiver extends BroadcastReceiver {
private static final String TAG = "TestOrderdBroadcastReceiver";
@Override
public void onReceive(Context context, Intent intent) {
String msg = getResultExtras(true).getString("msg");
Log.i(TAG, "ThirdBroadcastReceiver: " + msg);
}
}
我们注意到,在FirstReceiver和SecondReceiver中最后都使用了setResultExtras方法将一个Bundle对象设置 为结果集对象,传递到下一个接收者那里,这样以来,优先级低的接收者可以用getResultExtras获取到最新的经过处理的信息集合。
之后,我们需要为三个接收者注册广播地址,我们修改一下AndroidMainfest.xml文件:
<receiver android:name=".FirstBroadcastReceiver" >
<intent-filter android:priority="1000" >
<action android:name="android.intent.action.MY_BROADCAST" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</receiver>
<receiver android:name=".SecondBroadcastReceiver" >
<intent-filter android:priority="999" >
<action android:name="android.intent.action.MY_BROADCAST" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</receiver>
<receiver android:name=".ThirdBroadcastReceiver" >
<intent-filter android:priority="998" >
<action android:name="android.intent.action.MY_BROADCAST" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</receiver>
我们看到,现在这三个接收者的<intent-filter>多了一个android:priority属性,并且依次减小。这个属性的范围在-1000到1000,数值越大,优先级越高。
现在,我们需要写一下发送广播的代码,如下:
Intent intent = new Intent("android.intent.action.MY_BROADCAST");
intent.putExtra("msg", "hello receiver.");
sendOrderedBroadcast(intent, "myAndroid.permission.MY_BROADCAST_PERMISSION");
注意,使用sendOrderedBroadcast方法发送有序广播时,需要一个权限参数,如果为null则表示不要求接收者声明指定的权限,如果不为 null,则表示接收者若要接收此广播,需声明指定权限。这样做是从安全角度考虑的,例如系统的短信就是有序广播的形式,一个应用可能是具有拦截垃圾短信 的功能,当短信到来时它可以先接受到短信广播,必要时终止广播传递,这样的软件就必须声明接收短信的权限。
所以我们在AndroidMainfest.xml中定义一个权限:
<permission
android:name="myAndroid.permission.MY_BROADCAST_PERMISSION"
android:protectionLevel="normal" />
然后声明使用了此权限:
<uses-permission android:name="myAndroid.permission.MY_BROADCAST_PERMISSION" />
然后我们点击发送按钮发送一条广播,控制台打印如下:
12-20 08:13:45.978: I/TestOrderdBroadcastReceiver(29914): FirstBroadcastReceiver: hello receiver.
12-20 08:13:46.088: I/TestOrderdBroadcastReceiver(29914): SecondBroadcastReceiver: hello receiver.@FirstBroadcastReceiver
12-20 08:13:46.138: I/TestOrderdBroadcastReceiver(29914): ThirdBroadcastReceiver: hello receiver.@FirstBroadcastReceiver@SecondBroadcastReceiver
我们看到接收是按照顺序的,第一个和第二个都在结果集中加入了自己的标记,并且向优先级低的接收者传递下去。
既然是顺序传递,试着终止这种传递,看一看效果如何,我们修改FirstReceiver的代码,在onReceive的最后一行添加以下代码:
abortBroadcast();
然后再次运行程序,控制台打印如下:
12-20 08:13:45.978: I/TestOrderdBroadcastReceiver(29914): FirstBroadcastReceiver: hello receiver.
此次,只有第一个接收者执行了,其它两个都没能执行,因为广播被第一个接收者终止了。
注:只有有序广播可以用abortBroadcast();来终止,其他广播是没有效果的。
BroadcastReceiver的生命周期
BroadcastReceiver的生命周期很短,也就是onReceive的执行时间,onReceive执行结束,BroadcastReceiver的实例就被销毁(不管那种注册方法)
Broadcast Action 大全
android.intent.action.BATTERY_CHANGED
充电状态,或者电池的电量发生变化
android.intent.action.BOOT_COMPLETED
在系统启动后,这个动作被广播一次(只有一次)
android.intent.action.CFF
语音电话的呼叫转移状态已经改变
android.intent.action.CONFIGURATION_CHANGED
设备的配置信息已经改变,参见 Resources.Configuration
android.intent.action.DATA_ACTIVITY
电话的数据活动(data activity)状态(即收发数据的状态)已经改变
android.intent.action.DATA_STATE
电话的数据连接状态已经改变
android.intent.action.DATE_CHANGED
日期被改变
android.server.checkin.FOTA_CANCEL
取消所有被挂起的 (pending) 更新下载
android.server.checkin.FOTA_INSTALL
更新已经被确认,马上就要开始安装
android.server.checkin.FOTA_READY
更新已经被下载,可以开始安装
android.server.checkin.FOTA_RESTART
恢复已经停止的更新下载
android.server.checkin.FOTA_UPDATE
通过 OTA 下载并安装操作系统更新
android.intent.action.MEDIABUTTON
用户按下了"Media Button"
android.intent.action.MEDIA_BAD_REMOVAL
扩展介质(扩展卡)已经从 SD 卡插槽拔出,但是挂载点 (mount point) 还没解除 (unmount)
android.intent.action.MEDIA_EJECT
用户想要移除扩展介质(拔掉扩展卡)
android.intent.action.MEDIA_MOUNTED
扩展介质被插入,而且已经被挂载
android.intent.action.MEDIA_REMOVED
扩展介质被移除
android.intent.action.MEDIA_SCANNER_FINISHED
已经扫描完介质的一个目录
android.intent.action.MEDIA_SCANNER_STARTED
开始扫描介质的一个目录
android.intent.action.MEDIA_SHARED
扩展介质的挂载被解除 (unmount),因为它已经作为 USB 大容量存储被共享
android.intent.action.MEDIA_UNMOUNTED
扩展介质存在,但是还没有被挂载 (mount)
android.intent.action.MWI
电话的消息等待(语音邮件)状态已经改变
android.intent.action.NETWORK_TICKLE_RECEIVED
设备收到了新的网络 "tickle" 通知
android.intent.action.PACKAGE_ADDED
设备上新安装了一个应用程序包
android.intent.action.PACKAGE_REMOVED
设备上删除了一个应用程序包
android.intent.action.PHONE_STATE
电话状态已经改变
android.intent.action.PROVIDER_CHANGED
更新将要(真正)被安装
android.intent.action.PROVISIONING_CHECK
要求 polling of provisioning service 下载最新的设置
android.intent.action.SCREEN_OFF
屏幕被关闭
android.intent.action.SCREEN_ON
屏幕已经被打开
android.intent.action.SERVICE_STATE
电话服务的状态已经改变
android.intent.action.SIG_STR
电话的信号强度已经改变
android.intent.action.STATISTICS_REPORT
要求 receivers 报告自己的统计信息
android.intent.action.STATISTICS_STATE_CHANGED
统计信息服务的状态已经改变
android.intent.action.TIMEZONE_CHANGED
时区已经改变
android.intent.action.TIME_SET
时间已经改变(重新设置)
android.intent.action.TIME_TICK
当前时间已经变化(正常的时间流逝)
android.intent.action.UMS_CONNECTED
设备进入 USB 大容量存储模式。
android.intent.action.UMS_DISCONNECTED
设备从 USB 大容量存储模式退出
android.intent.action.WALLPAPER_CHANGED
系统的墙纸已经改变
android.intent.action.XMPP_CONNECTED
XMPP 连接已经被建立
android.intent.action.XMPP_DI
XMPP 连接已经被断开