BroadcastReceiver
1 . 定义
即 广播,是一个全局的监听器,属于Android
四大组件之一
Android 广播分为两个角色:广播发送者、广播接收者
2. 作用
监听 / 接收 应用 App
发出的广播消息,并做出响应
3. 应用场景
-
Android
不同组件间的通信(含 :应用内 / 不同应用之间) - 多线程通信
- 与
Android
系统在特定情况下的通信
如:电话呼入时、网络可用时
4. 实现原理
4.1 采用的模型
-
Android
中的广播使用了设计模式中的观察者模式:基于消息的发布 / 订阅事件模型
因此,Android将广播的发送者 和 接收者 解耦,使得系统方便集成,更易扩展
4.2 模型讲解
-
模型中有3个角色:
- 消息订阅者(广播接收者)
- 消息发布者(广播发布者)
- 消息中心(
AMS
,即Activity Manager Service
)
5. 使用流程
944365-7c9ff656ebd1b981.png5.1 自定义广播接收者BroadcastReceiver
- 继承
BroadcastReceivre
基类 - 必须复写抽象方法
onReceive()
方法
1.广播接收器接收到相应广播后,会自动回调 onReceive() 方法
2.一般情况下,onReceive方法会涉及 与 其他组件之间的交互,如发送Notification、启动Service等
3.默认情况下,广播接收器运行在 UI 线程,因此,onReceive()方法不能执行耗时操作,否则将导致ANR
// 继承BroadcastReceivre基类
public class MyReceiver extends BroadcastReceiver {
// 复写onReceive()方法
// 接收到广播后,则自动调用该方法
@Override
public void onReceive(Context context, Intent intent) {
//写入接收广播后的操作
}
}
5.2 广播接收器注册
注册的方式分为两种:静态注册、动态注册
5.2.1 静态注册
- 注册方式:在AndroidManifest.xml里通过<receive>标签声明
- 属性说明:
<receiver
android:enabled=["true" | "false"]
//此broadcastReceiver能否接收其他App的发出的广播
//默认值是由receiver中有无intent-filter决定的:如果有intent-filter,默认值为true,否则为false
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
//继承BroadcastReceiver子类的类名
android:name=".MyReceiver"
//具有相应权限的广播发送者发送的广播才能被此BroadcastReceiver所接收;
android:permission="string"
//BroadcastReceiver运行所处的进程
//默认为app的进程,可以指定独立的进程
//注:Android四大基本组件都可以通过此属性指定自己的独立进程
android:process="string" >
//用于指定此广播接收器将接收的广播类型
//本示例中给出的是用于接收开机的广播
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED"/>
</intent-filter>
</receiver>
- 注册示例
<receiver
//此广播接收者类是mBroadcastReceiver
android:name=".MyReceiver" >
//用于接收网络状态改变时发出的广播
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED"/>
</intent-filter>
</receiver>
当此 App
首次启动时,系统会自动实例化MyReceiver类,并注册到系统中。
5.2.2 动态注册
-
注册方式:在代码中调用
Context.registerReceiver()
方法 -
具体代码如下:
// 选择在Activity生命周期方法中的onResume()中注册
@Override
protected void onResume(){
super.onResume();
// 1. 实例化BroadcastReceiver子类 & IntentFilter
MyReceiver mBroadcastReceiver = new MyReceiver();
IntentFilter intentFilter = new IntentFilter();
// 2. 设置接收广播的类型,网络变化
intentFilter.addAction(ConnectivityManager.CONNECTIVITY_ACTION);
// 3. 动态注册:调用Context的registerReceiver()方法
registerReceiver(mBroadcastReceiver, intentFilter);
}
// 注册广播后,要在相应位置记得销毁广播
// 即在onPause() 中unregisterReceiver(mBroadcastReceiver)
// 当此Activity实例化时,会动态将MyBroadcastReceiver注册到系统中
// 当此Activity销毁时,动态注册的MyBroadcastReceiver将不再接收到相应的广播。
@Override
protected void onPause() {
super.onPause();
//销毁在onResume()方法中的广播
unregisterReceiver(mBroadcastReceiver);
}
}
特别注意
- 动态广播最好在
Activity
的onResume()
注册、onPause()
注销。 - 原因:
- 对于动态广播,有注册就必然得有注销,否则会导致内存泄露
- 重复注册、重复注销也不允许
在onResume()注册、onPause()注销是因为onPause()在App死亡前一定会被执行,从而保证广播在App死亡前一定会被注销,从而防止内存泄露。
5.2.3 两种注册方式的区别
944365-8d163ab3ca20de0b (1).png5.3 广播发送者向AMS发送广播
5.3.1 广播的发送
- 广播 是 用”意图(
Intent
)“标识 - 定义广播的本质 = 定义广播所具备的“意图(
Intent
)” - 广播发送 = 广播发送者 将此广播的“意图(
Intent
)”通过sendBroadcast()方法发送出去
5.3.2 广播的类型
广播的类型主要分为5类:
- 普通广播(
Normal Broadcast
) - 系统广播(
System Broadcast
) - 有序广播(
Ordered Broadcast
) - 粘性广播(
Sticky Broadcast
) - App应用内广播(
Local Broadcast
)
具体说明如下:
1. 普通广播(Normal Broadcast)
即 开发者自身定义 intent
的广播(最常用)。发送广播使用如下:
Intent intent = new Intent("lalala");//"lalala"是广播的action
//8.0开始自定义广播系统不建议静态注册,如果静态注册,需要加下面这行代码,指定广播的类
//intent.setComponent(new ComponentName(this,MyReceiver.class));
sendBroadcast(intent);
若被注册了的广播接收者中注册时intentFilter
的action
与上述匹配,则会接收此广播(即进行回调onReceive()
)。若发送广播有相应权限,那么广播接收者也需要相应权限
2. 系统广播(System Broadcast)
- Android中内置了多个系统广播:只要涉及到手机的基本操作(如开机、网络状态变化、拍照等等),都会发出相应的广播
- 每个广播都有特定的Intent - Filter(包括具体的action),Android系统广播action如下:
系统操作 | action |
---|---|
监听网络变化 | android.net.conn.CONNECTIVITY_CHANGE |
关闭或打开飞行模式 | Intent.ACTION_AIRPLANE_MODE_CHANGED |
充电时或电量发生变化 | Intent.ACTION_BATTERY_CHANGED |
电池电量低 | Intent.ACTION_BATTERY_LOW |
电池电量充足 | Intent.ACTION_BATTERY_OKAY |
系统启动完成后(仅广播一次) | Intent.ACTION_BOOT_COMPLETED |
按下照相时的拍照按键(硬件按键) | Intent.ACTION_CAMERA_BUTTON |
屏幕锁屏 | Intent.Intent.ACTION_SCREEN_OFF |
屏幕解锁 | Intent.Intent.ACTION_SCREEN_ON |
设备当前设置被改变时(界面语言、设备方向等) | Intent.ACTION_CONFIGURATION_CHANGED |
插入耳机时 | Intent.ACTION_HEADSET_PLUG |
未正确移除SD卡但已取出来时(正确移除方法:设置--SD卡和设备内存--卸载SD卡) | Intent.ACTION_MEDIA_BAD_REMOVAL |
插入外部储存装置(如SD卡) | Intent.ACTION_MEDIA_CHECKING |
成功安装APK | Intent.ACTION_PACKAGE_ADDED |
成功删除APK | Intent.ACTION_PACKAGE_REMOVED |
重启设备 | Intent.ACTION_REBOOT |
屏幕被关闭 | Intent.ACTION_SCREEN_OFF |
屏幕被打开 | Intent.ACTION_SCREEN_ON |
关闭系统时 | Intent.ACTION_SHUTDOWN |
重启设备 | Intent.ACTION_REBOOT |
只能动态注册的广播:
android.intent.action.SCREEN_ON//屏幕打开
android.intent.action.SCREEN_OFF//屏幕关闭
android.intent.action.BATTERY_CHANGED//电量变化
android.intent.action.CONFIGURATION_CHANGED//设备的配置信息已经改变
android.intent.action.TIME_TICK//时间相关的广播
android.net.conn.CONNECTIVITY_CHANGE//网络状态发生改变,Android7.0之后只能动态注册
网络改变接收器:
public class NetReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
ConnectivityManager connectivityManager = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo activeNetworkInfo = connectivityManager.getActiveNetworkInfo();
if (activeNetworkInfo != null && activeNetworkInfo.isConnected()) {
Toast.makeText(context, "net isConnected", Toast.LENGTH_SHORT).show();
Log.e("TAG", "网络连接成功");
} else {
Toast.makeText(context, "net disConnected", Toast.LENGTH_SHORT).show();
Log.e("TAG", "网络连接失败");
}
}
}
3. 有序广播(Ordered Broadcast)
-
定义:
发送出去的广播被广播接收者按照先后顺序接收,有序是针对广播接收者而言的
-
广播接受者接收广播的顺序规则(同时面向静态和动态注册的广播接受者)
a. 按照Priority属性值从大-小排序;
b. Priority属性相同者,动态注册的广播优先; -
特点
a. 接收广播按顺序接收
b. 先接收的广播接收者可以对广播进行截断,即后接收的广播接收者不再接收到此广播;
c. 先接收的广播接收者可以对广播进行修改,那么后接收的广播接收者将接收到被修改后的广播
具体使用
有序广播的使用过程与普通广播非常类似,差异仅在于广播的发送方式:
sendOrderedBroadcast(intent);
注册广播:
private void register() {
mCityReceiver = new CityReceiver();
IntentFilter intentFilter2 = new IntentFilter();
intentFilter2.setPriority(0);
intentFilter2.addAction("com.cumulus.xts.AWARD");
registerReceiver(mCityReceiver, intentFilter2);
mProvinceReceiver = new ProvinceReceiver();
IntentFilter intentFilter = new IntentFilter();
intentFilter.setPriority(1000);
intentFilter.addAction("com.cumulus.xts.AWARD");
registerReceiver(mProvinceReceiver, intentFilter);
mLaoMaReceiver = new LaoMaReceiver();
IntentFilter intentFilter3 = new IntentFilter();
intentFilter3.setPriority(-1000);
intentFilter3.addAction("com.cumulus.xts.AWARD");
registerReceiver(mLaoMaReceiver, intentFilter3);
}
@Override
protected void onPause() {
super.onPause();
unregisterReceiver(mProvinceReceiver);
unregisterReceiver(mCityReceiver);
unregisterReceiver(mLaoMaReceiver);
}
public class ProvinceReceiver extends BroadcastReceiver {
private static final String TAG = "ProvinceReceiver";
@Override
public void onReceive(Context context, Intent intent) {
Log.d(TAG, "州里收到通知: "+getResultData());
//篡改数据
setResultData("特朗普个奥巴马发了7斤大米");
}
}
4. 粘性广播(Sticky Broadcast)
粘性消息在发送后就一直存在于系统的消息容器里面,等待对应的处理器去处理,如果暂时没有处理器处理这个消息则一直在消息容器里面处于等待状态,粘性广播的Receiver如果被销毁,那么下次重建时会自动接收到消息数据。
注意:普通广播和粘性消息不能被截获,而有序广播是可以被截获的。
发送粘性广播需要权限(这里的权限是保存信息的权限和由系统发送未处理的广播的权限)
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
对于粘性广播的发送,和普通广播的发送方式是一致的
Intent intent = new Intent("com.xts.sticky");
intent.putExtra("data","粘性广播来了");
sendStickyBroadcast(intent);
//removeStickyBroadcast(intent);//移除广播
}
需要知道的是粘性广播是普通广播的一种,因此也可以使用普通广播接收器来接收,当然粘性广播还有另一种常用的接收方式。
4.1.使用普通广播接收器,注意,必须在Manifiest或者发送之前接收(这和定义有点违背,因为这种方式不是正确的接收方式)
public class StickyBroadcastReceiver extends BroadcastReceiver {
public static final String Action = "com.xts.sticky";
@Override
public void onReceive(Context context, Intent intent)
{
Log.d("StickyBroadcastReceiver", "register: "+intent.getStringExtra("data"));
}
}
<receiver android:name=".StickyBroadcastReceiver"
<intent-filter >
<action android:name="com.xts.sticky"/>
</intent-filter>
</receiver>
4.2.使用正确的方式接收(推荐)
正确的接收方式不应该使用BroadcastReceiver就可以接收到
只需要将Activity的onResume稍作修改即可
IntentFilter intentFilter4 = new IntentFilter();
intentFilter4.addAction("com.xts.sticky");
//注意,不需要接收器,否则可能无法接收到
Intent intent = registerReceiver(null, intentFilter4);
if (intent !=null){
Log.d(TAG, "register: "+intent.getStringExtra("data"));
}
这种广播也可以被移除 ,我们可以接收到 广播后调用 removeStickyBroadcast(intent);
粘性广播在Android5.0 & API 21中已经失效,
5. App应用内广播(Local Broadcast)
-
背景
Android中的广播可以跨App直接通信(exported对于有intent-filter情况下默认值为true) -
冲突
可能出现的问题:
- 其他App针对性发出与当前App intent-filter相匹配的广播,由此导致当前App不断接收广播并处理;
- 其他App注册与当前App一致的intent-filter用于接收广播,获取广播具体信息;
即会出现安全性 & 效率性的问题。
- 解决方案
使用App应用内广播(Local Broadcast)
1.App应用内广播可理解为一种局部广播,广播的发送者和接收者都同属于一个App。
2.相比于全局广播(普通广播),App应用内广播优势体现在:安全性高 & 效率高
具体使用1 - 将全局广播设置成局部广播
- 注册广播时将exported属性设置为false,使得非本App内部发出的此广播不被接收;
- 在广播发送和接收时,增设相应权限permission,用于权限验证;
- 发送广播时指定该广播接收器所在的包名,此广播将只会发送到此包中的App内与之相匹配的有效广播接收器中。
通过intent.setPackage(packageName)指定报名
具体使用2 - 使用封装好的LocalBroadcastManager类
使用方式上与全局广播几乎相同,只是注册/取消注册广播接收器和发送广播时将参数的context变成了LocalBroadcastManager的单一实例
注:对于LocalBroadcastManager方式发送的应用内广播,只能通过LocalBroadcastManager动态注册,不能静态注册
//注册应用内广播接收器
//步骤1:实例化BroadcastReceiver子类 & IntentFilter mBroadcastReceiver
mBroadcastReceiver = new MyReceiver();
IntentFilter intentFilter = new IntentFilter();
//步骤2:实例化LocalBroadcastManager的实例
localBroadcastManager = LocalBroadcastManager.getInstance(this);
//步骤3:设置接收广播的类型
intentFilter.addAction("com.xts.local");
//步骤4:调用LocalBroadcastManager单一实例的registerReceiver()方法进行动态注册
localBroadcastManager.registerReceiver(mBroadcastReceiver, intentFilter);
//取消注册应用内广播接收器
localBroadcastManager.unregisterReceiver(mBroadcastReceiver);
//发送应用内广播
Intent intent = new Intent();
intent.setAction("com.xts.local");
localBroadcastManager.sendBroadcast(intent);
6. 特别注意
对于不同注册方式的广播接收器回调OnReceive(Context context,Intent intent)中的context返回值是不一样的:
- 对于静态注册(全局+应用内广播),回调onReceive(context, intent)中的context返回值是:ReceiverRestrictedContext;
- 对于全局广播的动态注册,回调onReceive(context, intent)中的context返回值是:Activity Context;
- 对于应用内广播的动态注册(LocalBroadcastManager方式),回调onReceive(context, intent)中的context返回值是:Application Context。
- 对于应用内广播的动态注册(非LocalBroadcastManager方式),回调onReceive(context, intent)中的context返回值是:Activity Context;
- 在广播中启动activity的话,需要为intent加入FLAG_ACTIVITY_NEW_TASK的标记,不然会报错,因为需要一个栈来存放新打开的activity。
- 广播中弹出AlertDialog的话,需要设置对话框的类型为:TYPE_SYSTEM_ALERT不然是无法弹出的。