broadcastreceiver也就是“广播接收者”的意思,它是用来接收来自系统和应用中的广播。
在android中,broadcast是一种广泛运用的在应用程序之间传输信息的机制。而broadcastreceiver是对发送出来的 broadcast进行过滤接受并响应的一类组件。
下面将详细的阐述如何发送broadcast和使用broadcastreceiver过滤接收的过程:
(1)首先在需要发送信息的地方,把要发送的信息和用于过滤的信息(如action、category)装入一个intent对象,然后通过调用 sendorderbroadcast()或sendstickybroadcast()方法,把 intent对象以广播方式发送出去。
(2)当intent发送以后,所有已经注册的broadcastreceiver会检查注册时的intentfilter是否与发送的intent相匹配,若匹配则就会调用broadcastreceiver的onreceive()方法。所以当我们定义一个broadcastreceiver的时候,都需要实现onreceive()方法。
注册broadcastreceiver有两种方式
静态注册:在androidmanifest.xml中用标签生命注册,并在标签内用标签设置过滤器。
1
2
3
4
5
|
<receiver android:name= "myrecevice" > //继承broadcastreceiver,重写onreceiver方法 <intent-filter> <action android:name= "com.lc.test" /> //使用过滤器,接收指定action广播 </intent-filter> </receiver> |
动态注册: 使用intentfilter在代码中动态的注册一个广播
1
2
3
4
|
intentfilter intentfilter = new intentfilter(); //为broadcastreceiver指定action,使之用于接收同action的广播 intentfilter.addaction(string); registerreceiver(broadcastreceiver,intentfilter); |
另外值得注意的是,当我们使用动态注册时候,当这个activity或service被销毁时如果没有解除注册,系统会报一个异常,提示我们是否忘记解除注册了,所以我们需要在ondestroy()方法中进行解除注册,一般:在onstart中注册,onstop中取消unregisterreceiver:
1
2
3
4
5
|
@override protected void ondestroy() { super .ondestroy(); unregisterreceiver(receiver); } |
指定广播目标action:intent intent = new intent(actionstring);
并且可通过intent携带消息 :intent.putextra(“msg”, “hi,我通过广播发送消息了”);
发送广播消息:context.sendbroadcast(intent )
其中在动态注册中可将broadcastreceiver的继承类进行封装,添加构造函数和broadcastreceiver注册
broadcastreceiver的案例演示
首先我们创建一个类mybroadcastreceiver用于继承broadcastreceiver:
这里重写了一个方法就是接受广播的意图并匹配:
1
2
|
//定义的为:public static final string //action_register_success_finish="register.success.finish"; constants.action_register_success_finish.equals(intent.getaction()) |
这里是常量:定义如下:
1
2
3
4
5
6
7
8
9
|
public class mybroadcastreceiver extends broadcastreceiver { @override public void onreceive(context context, intent intent) { if (intent != null && constants.action_register_success_finish.equals(intent.getaction())) { finish(); } } } |
(1)接下里我们就通过“动态注册”的方式使用:
1
2
3
4
|
private mybroadcastreceiver receiver = new mybroadcastreceiver(); intentfilter filter = new intentfilter(); filter.addaction(bmobconstants.action_register_success_finish); //添加action registerreceiver(receiver, filter); //注册 |
(2)静态注册的话是现在清单文件中添加:
1
2
3
4
5
6
|
<receiver android:name= ".mybroadcastreceiver" > <intent-filter> <action android:name= "register.success.finish" /> <category android:name= "android.intent.category.default" /> </intent-filter> </receiver> |
(2-1)我们就可以使用代码了:
1
2
3
|
intent intent = new intent( "register.success.finish" ); intent.putextra( "msg" , "hello receiver." ); sendbroadcast(intent); //发送广播 |
普通广播(normal broadcast)
普通广播对于多个接收者来说是完全异步的,通常每个接收者都无需等待即可以接收到广播,接收者相互之间不会有影响。对于这种广播,接收者无法终止广播,即无法阻止其他接收者的接收动作。为了验证以上论断,我们新建三个broadcastreceiver,演示一下这个过程,firstreceiver、secondreceiver和thirdreceiver的代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.util.log; public class firstreceiver extends broadcastreceiver { private static final string tag = "normalbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = intent.getstringextra( "msg" ); log.i(tag, "firstreceiver: " + msg); } } |
1
2
3
4
5
6
7
8
9
10
|
public class secondreceiver extends broadcastreceiver { private static final string tag = "normalbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = intent.getstringextra( "msg" ); log.i(tag, "secondreceiver: " + msg); } } |
1
2
3
4
5
6
7
8
9
10
|
public class thirdreceiver extends broadcastreceiver { private static final string tag = "normalbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = intent.getstringextra( "msg" ); log.i(tag, "thirdreceiver: " + msg); } } |
然后再次点击发送按钮,发送一条广播,控制台打印如下:
看来这三个接收者都接收到这条广播了,我们稍微修改一下三个接收者,在onreceive方法的最后一行添加以下代码,试图终止广播:
1
|
abortbroadcast(); |
再次点击发送按钮,我们会发现,控制台中三个接收者仍然都打印了自己的日志,表明接收者并不能终止广播。
有序广播(ordered broadcast)
有序广播比较特殊,它每次只发送到优先级较高的接收者那里,然后由优先级高的接受者再传播到优先级低的接收者那里,优先级高的接收者有能力终止这个广播。
为了演示有序广播的流程,我们修改一下上面三个接收者的代码,如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.os.bundle; import android.util.log; public class firstreceiver extends broadcastreceiver { private static final string tag = "orderedbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = intent.getstringextra( "msg" ); log.i(tag, "firstreceiver: " + msg); bundle bundle = new bundle(); bundle.putstring( "msg" , msg + "@firstreceiver" ); setresultextras(bundle); } } |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
public class secondreceiver extends broadcastreceiver { private static final string tag = "orderedbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = getresultextras( true ).getstring( "msg" ); log.i(tag, "secondreceiver: " + msg); bundle bundle = new bundle(); bundle.putstring( "msg" , msg + "@secondreceiver" ); setresultextras(bundle); } } |
1
2
3
4
5
6
7
8
9
10
|
public class thirdreceiver extends broadcastreceiver { private static final string tag = "orderedbroadcast" ; @override public void onreceive(context context, intent intent) { string msg = getresultextras( true ).getstring( "msg" ); log.i(tag, "thirdreceiver: " + msg); } } |
我们注意到,在firstreceiver和secondreceiver中最后都使用了setresultextras方法将一个bundle对象设置为结果集对象,传递到下一个接收者那里,这样以来,优先级低的接收者可以用getresultextras获取到最新的经过处理的信息集合。
代码改完之后,我们需要为三个接收者注册广播地址,我们修改一下androidmainfest.xml文件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
<receiver android:name= ".firstreceiver" > <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= ".secondreceiver" > <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= ".thirdreceiver" > <intent-filter android:priority= "998" > <action android:name= "android.intent.action.my_broadcast" /> <category android:name= "android.intent.category.default" /> </intent-filter> </receiver> |
我们看到,现在这三个接收者的多了一个android:priority属性,并且依次减小。这个属性的范围在-1000到1000,数值越大,优先级越高。
现在,我们需要修改一下发送广播的代码,如下:
1
2
3
4
5
|
public void send(view view) { intent intent = new intent( "android.intent.action.my_broadcast" ); intent.putextra( "msg" , "hello receiver." ); sendorderedbroadcast(intent, "scott.permission.my_broadcast_permission" ); } |
注意,使用sendorderedbroadcast方法发送有序广播时,需要一个权限参数,如果为null则表示不要求接收者声明指定的权限,如果不为null,则表示接收者若要接收此广播,需声明指定权限。这样做是从安全角度考虑的,例如系统的短信就是有序广播的形式,一个应用可能是具有拦截垃圾短信的功能,当短信到来时它可以先接受到短信广播,必要时终止广播传递,这样的软件就必须声明接收短信的权限。
所以我们在androidmainfest.xml中定义一个权限:
1
2
|
<permission android:protectionlevel= "normal" android:name= "scott.permission.my_broadcast_permission" /> |
然后声明使用了此权限:
1
|
<uses-permission android:name= "scott.permission.my_broadcast_permission" /> |
关于这部分如果有不明白的地方可以参考我之前写过的一篇文章:android声明和使用权限
然后我们点击发送按钮发送一条广播,控制台打印如下:
我们看到接收是按照顺序的,第一个和第二个都在结果集中加入了自己的标记,并且向优先级低的接收者传递下去。
既然是顺序传递,试着终止这种传递,看一看效果如何,我们修改firstreceiver的代码,在onreceive的最后一行添加以下代码:
1
|
abortbroadcast(); |
然后再次运行程序,控制台打印如下:
此次,只有第一个接收者执行了,其它两个都没能执行,因为广播被第一个接收者终止了。
上面就是broadcastreceiver的介绍,下面我将会举几个常见的例子加深一下大家对广播的理解和应用:
1.开机启动服务
我们经常会有这样的应用场合,比如消息推送服务,需要实现开机启动的功能。要实现这个功能,我们就可以订阅系统“启动完成”这条广播,接收到这条广播后我们就可以启动自己的服务了。我们来看一下bootcompletereceiver和msgpushservice的具体实现:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.util.log; public class bootcompletereceiver extends broadcastreceiver { private static final string tag = "bootcompletereceiver" ; @override public void onreceive(context context, intent intent) { intent service = new intent(context, msgpushservice. class ); context.startservice(service); log.i(tag, "boot complete. starting msgpushservice..." ); } } |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
import android.app.service; import android.content.intent; import android.os.ibinder; import android.util.log; public class msgpushservice extends service { private static final string tag = "msgpushservice" ; @override public void oncreate() { super .oncreate(); log.i(tag, "oncreate called." ); } @override public int onstartcommand(intent intent, int flags, int startid) { log.i(tag, "onstartcommand called." ); return super .onstartcommand(intent, flags, startid); } @override public ibinder onbind(intent arg0) { return null ; } } |
然后我们需要在androidmanifest.xml中配置相关信息:
1
2
3
4
5
6
7
8
9
10
|
<!-- 开机广播接受者 --> <receiver android:name= ".bootcompletereceiver" > <intent-filter> <!-- 注册开机广播地址--> <action android:name= "android.intent.action.boot_completed" /> <category android:name= "android.intent.category.default" /> </intent-filter> </receiver> <!-- 消息推送服务 --> <service android:name= ".msgpushservice" /> |
我们看到bootcompletereceiver注册了“android.intent.action.boot_completed”这个开机广播地址,从安全角度考虑,系统要求必须声明接收开机启动广播的权限,于是我们再声明使用下面的权限:
经过上面的几个步骤之后,我们就完成了开机启动的功能,将应用运行在模拟器上,然后重启模拟器,控制台打印如下:
如果我们查看已运行的服务就会发现,msgpushservice已经运行起来了。
2.网络状态变化
在某些场合,比如用户浏览网络信息时,网络突然断开,我们要及时地提醒用户网络已断开。要实现这个功能,我们可以接收网络状态改变这样一条广播,当由连接状态变为断开状态时,系统就会发送一条广播,我们接收到之后,再通过网络的状态做出相应的操作。下面就来实现一下这个功能:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.net.connectivitymanager; import android.net.networkinfo; import android.util.log; import android.widget.toast; public class networkstatereceiver extends broadcastreceiver { private static final string tag = "networkstatereceiver" ; @override public void onreceive(context context, intent intent) { log.i(tag, "network state changed." ); if (!isnetworkavailable(context)) { toast.maketext(context, "network disconnected!" , 0 ).show(); } } /** * 网络是否可用 */ public static boolean isnetworkavailable(context context) { connectivitymanager mgr = (connectivitymanager) context.getsystemservice(context.connectivity_service); networkinfo[] info = mgr.getallnetworkinfo(); if (info != null ) { for ( int i = 0 ; i < info.length; i++) { if (info[i].getstate() == networkinfo.state.connected) { return true ; } } } return false ; } } |
再注册一下这个接收者的信息:
1
2
3
4
5
6
|
<receiver android:name= ".networkstatereceiver" > <intent-filter> <action android:name= "android.net.conn.connectivity_change" /> <category android:name= "android.intent.category.default" /> </intent-filter> </receiver> |
因为在isnetworkavailable方法中我们使用到了网络状态相关的api,所以需要声明相关的权限才行,下面就是对应的权限声明:
1
|
<uses-permission android:name= "android.permission.access_network_state" /> |
我们可以测试一下,比如关闭wifi,看看有什么效果。
3.电量变化
如果我们阅读软件,可能是全屏阅读,这个时候用户就看不到剩余的电量,我们就可以为他们提供电量的信息。要想做到这一点,我们需要接收一条电量变化的广播,然后获取百分比信息,这听上去挺简单的,我们就来实现以下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.os.batterymanager; import android.util.log; public class batterychangedreceiver extends broadcastreceiver { private static final string tag = "batterychangedreceiver" ; @override public void onreceive(context context, intent intent) { int currlevel = intent.getintextra(batterymanager.extra_level, 0 ); //当前电量 int total = intent.getintextra(batterymanager.extra_scale, 1 ); //总电量 int percent = currlevel * 100 / total; log.i(tag, "battery: " + percent + "%" ); } } |
然后再注册一下广播接地址信息就可以了:
1
2
3
4
5
6
|
<receiver android:name= ".batterychangedreceiver" > <intent-filter> <action android:name= "android.intent.action.battery_changed" /> <category android:name= "android.intent.category.default" /> </intent-filter> </receiver> |
当然,有些时候我们是要立即获取电量的,而不是等电量变化的广播,比如当阅读软件打开时立即显示出电池电量。我们可以按以下方式获取:
1
2
3
4
5
6
|
intent batteryintent = getapplicationcontext().registerreceiver( null , new intentfilter(intent.action_battery_changed)); int currlevel = batteryintent.getintextra(batterymanager.extra_level, 0 ); int total = batteryintent.getintextra(batterymanager.extra_scale, 1 ); int percent = currlevel * 100 / total; log.i( "battery" , "battery: " + percent + "%" ); |
以上就是本文的全部内容,希望对大家的学习有所帮助。