全局大喇叭——BroadcastReceiver

本篇文章记述了Android的四大组件之一 —— BroadcastReceiver(广播接收者)。广播的作用、广播注册的方式、自定义广播、广播的类型以及在较新的Android系统中使用BroadcastReceiver需要注意的问题。Android 应用与 Android 系统和其他 Android 应用之间可以相互收发广播消息,这与发布-订阅设计模式相似,这些广播会在所关注的事件发生时发送出去。

关于系统广播

举例来说,Android 系统会在发生各种系统事件时发送广播,例如系统启动或设备开始充电时。应用可以发送自定义广播来通知其他应用它们可能感兴趣的事件(例如,一些新数据已下载)。应用可以注册接收特定的广播。广播发出后,系统会自动将广播传送给同意接收这种广播的应用。

系统会在发生各种系统事件时自动发送广播,例如当系统进入和退出飞行模式时,系统广播会被发送给所有同意接收相关事件的应用,或者在手机低电量的时候,系统也会发出一个手机电量低的广播:

常见的系统广播:

 1<!-- 开机广播 -->
 2<action android:name="android.intent.action.BOOT_COMPLETED"/>
 3
 4<!-- 开始充电广播 -->
 5<action android:name="android.intent.action.ACTION_POWER_CONNECTED"/>
 6
 7<!-- 低电量广播 -->
 8<action android:name="android.intent.action.BATTERY_LOW"/>
 9
10<!-- 应用卸载广播 -->
11<action android:name="android.intent.action.PACKAGE_REMOVED"/>
12
13<!-- 应用安装广播 -->
14<action android:name="android.intent.action.PACKAGE_ADDED"/>
15
16<!-- 声明这个数据类型才可以收到应用安装/卸载的广播 -->
17<data android:scheme="package"/>
18
19<... />

系统广播的注册

应用程序可以通过两种方式接收广播:通过清单文件声明的广播接收者和上下文注册的广播接收者。

静态注册

首先作为四大组件之一肯定是要在清单文件声明的,创建一个AppReceiver用来接收App安装和卸载的广播,此类要继承BroadcastReceiver:

 1public class AppReceiver extends BroadcastReceiver {
 2    private static final String TAG = "AppReceiver";
 3    
 4    @Override
 5    public void onReceive(Context context, Intent intent) {
 6        // 接收广播
 7        if(intent != null){
 8            // 判断收到的是什么广播
 9            String action = intent.getAction();
10            assert action != null;
11            switch (action){
12                case Intent.ACTION_PACKAGE_REMOVED:
13                    Log.i(TAG, "onReceive: ACTION_PACKAGE_REMOVED " + "应用被卸载");
14                    break;
15                case Intent.ACTION_PACKAGE_ADDED:
16                    Log.i(TAG, "onReceive: ACTION_PACKAGE_ADDED " + "应用被安装");
17                    break;
18            }
19        }
20    }
21}

AndroidManifest.xml

 1<!-- 静态注册广播接收者 -->
 2<receiver android:name=".AppReceiver"
 3          android:enabled="true"
 4          android:exported="true">
 5    <intent-filter>
 6        <!-- 应用卸载广播 -->
 7        <action android:name="android.intent.action.PACKAGE_REMOVED"/>
 8        <!-- 应用安装广播 -->
 9        <action android:name="android.intent.action.PACKAGE_ADDED"/>
10        <!-- 声明这个数据类型才可以收到应用安装/卸载的广播 -->
11        <data android:scheme="package"/>
12    </intent-filter>
13</receiver>

在进行应用卸载和安装的时候,就可以收到对应的广播了:

动态注册

AppReceiver.java还是和上面的一样,但是现在不在AndroidManifest.xml中声明,而是使用动态注册的方式,下面的例子演示了如何在Activity创建的动态的注册广播接收者:

MainActivity.java

 1public class MainActivity extends AppCompatActivity {
 2
 3    private BroadcastReceiver receiver;
 4
 5    @Override
 6    protected void onCreate(Bundle savedInstanceState) {
 7        super.onCreate(savedInstanceState);
 8        setContentView(R.layout.activity_main);
 9        // 新建一个广播接收器
10        receiver = new AppReceiver();
11        
12        // 接收哪些广播
13        IntentFilter intentFilter = new IntentFilter();
14        intentFilter.addDataScheme("package");
15        intentFilter.addAction(Intent.ACTION_PACKAGE_ADDED);
16        intentFilter.addAction(Intent.ACTION_PACKAGE_REMOVED);
17
18        // 注册广播接收者
19        registerReceiver(receiver, intentFilter);
20    }
21
22    @Override
23    protected void onDestroy() {
24        super.onDestroy();
25        // 取消注册广播接收器(不取消会导致内存泄漏)
26        if(receiver != null){
27            unregisterReceiver(receiver);
28        }
29    }
30}

不过动态注册广播接收者千万别忘记在Activity销毁的时候解除之前注册的广播接收者。

静态注册需要在AndroidManifest.xml中声明,只要APP启动过一次,所静态注册的广播就会生效,无论当前的APP处于停止使用还是正在使用状态。只要相应的广播事件发生,系统就会遍历所有的清单文件,通知相应的广播接收者接收广播,然后调用广播接收者的onReceiver方法。

动态注册动态注册方式依赖于所注册的组件,当APP关闭后,组件对象都不在了动态注册的代码都不存在了,所动态注册监听的Action自然就不再生效了。静态注册的广播传播速度要远远慢于动态注册的广播。

如果即使用了动态注册,又使用了静态注册,那么动态动态注册的广播的优先级大于静态注册的广播。

广播的生命周期

1、BroadCastReceiver 的生命周期很短暂,当接收到广播的时候创建,当onReceive()方法结束后销毁

2、正因为BroadCastReceiver的声明周期很短暂,所以不要在广播接收器中去创建子线程做耗时的操作,因为广播接受者被销毁后,这个子进程就会成为空进程,很容易被杀死

3、因为BroadCastReceiver是运行在主线程的,所以不能直接在BroadCastReceiver中去做耗时的操作,否则就会出现ANR异常 ,耗时的较长的工作最好放到Service中去完成。这里不能使用子线程来解决 , 因为BroadcastReceiver的生命周期很短,子线程可能还没有结束BroadcastReceiver就先结束了,BroadcastReceiver一旦结束,此时BroadcastReceiver的所在进程很容易在系统需要内存时被优先杀死,因为它属于空进程 ( 没有任何活动组件的进程 ),如果它的宿主进程被杀死,那么正在工作的子线程也会被杀死,所以采用子线程来解决是不可靠的。

自定义Broadcast

MainActivity.java

 1public class MainActivity extends AppCompatActivity {
 2
 3    public static final String MY_ACTION = "cn.tim.action.MY_ACTION";
 4    public static final String MY_ACTION_EXTRA_KEY = "input_content";
 5    private EditText etContent;
 6    private CustomReceiver receiver;
 7
 8    @Override
 9    protected void onCreate(Bundle savedInstanceState) {
10        super.onCreate(savedInstanceState);
11        setContentView(R.layout.activity_main);
12        etContent = findViewById(R.id.et_content);
13        TextView tvShow = findViewById(R.id.tv_show);
14
15        receiver = new CustomReceiver();
16        receiver.tvShow = tvShow;
17
18        IntentFilter filter = new IntentFilter();
19        filter.addAction(MY_ACTION);
20        registerReceiver(receiver, filter);
21    }
22
23    public void send(View view) {
24        // 新建广播
25        Intent intent = new Intent(MY_ACTION);
26        // 放入广播要携带的数据
27        intent.putExtra(MY_ACTION_EXTRA_KEY, etContent.getText().toString());
28        sendBroadcast(intent);
29    }
30
31    @Override
32    protected void onDestroy() {
33        super.onDestroy();
34        // 解除注册
35        if(receiver != null){
36            unregisterReceiver(receiver);
37        }
38    }
39}

CustomReceiver.java

 1public class CustomReceiver extends BroadcastReceiver {
 2    TextView tvShow;
 3
 4    @Override
 5    public void onReceive(Context context, Intent intent) {
 6        if(intent != null){
 7            String action = intent.getAction();
 8            if(MainActivity.MY_ACTION.equals(action)){
 9                String inputContent = intent.getStringExtra(MainActivity.MY_ACTION_EXTRA_KEY);
10                tvShow.setText(inputContent);
11            }
12        }
13    }
14}

不同的应用间通信,也是上面同样的代码,只要写相同的ACTION,那么就OK了:

Broadcast分类

广播的发送,可以分为有序广播、无序广播、本地广播以及粘性广播。

有序广播

有序广播是一种分先后广播接收器的广播,广播接收者的优先级越高,越先接收广播。优先级高的广播先收到广播,收到广播后可以修改广播的内容,也可以拦截广播不让广播向下传递。

如果在CReceiver中终止广播,那么优先级比较低的A与B都收不到广播了。

MainActivity.java

 1public class MainActivity extends AppCompatActivity {
 2    public static final String MY_ACTION = "cn.tim.action.MY_ACTION";
 3    public static final String KEY = "cn.tim.action.MY_ACTION";
 4
 5    @Override
 6    protected void onCreate(Bundle savedInstanceState) {
 7        super.onCreate(savedInstanceState);
 8        setContentView(R.layout.activity_main);
 9
10        // 新建广播
11        Intent intent = new Intent(MY_ACTION);
12        // 放入广播要携带的数据
13        Bundle bundle = new Bundle();
14        bundle.putInt(KEY, 100);
15        intent.putExtras(bundle);
16        //sendBroadcast(intent);
17
18        // 发送顺序广播,参数二:权限
19        sendOrderedBroadcast(intent, null);
20    }
21}
22

注意:如果要修改数据的话前提得是Intent发送数据得格式必须是Bundle。

 1// 优先级 2
 2public class CReceiver extends BroadcastReceiver {
 3    @Override
 4    public void onReceive(Context context, Intent intent) {
 5        if(intent != null){
 6            String action = intent.getAction();
 7            if(MainActivity.MY_ACTION.equals(action)){
 8                Bundle bundle = intent.getExtras();
 9                Toast.makeText(context, "C:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
10                Bundle newBundle = new Bundle();
11                newBundle.putInt(MainActivity.KEY, 90);
12                setResultExtras(newBundle);
13            }
14        }
15    }
16}
17
18// 优先级 1
19public class AReceiver extends BroadcastReceiver {
20    @Override
21    public void onReceive(Context context, Intent intent) {
22        if(intent != null){
23            String action = intent.getAction();
24            if(MainActivity.MY_ACTION.equals(action)){
25                Bundle bundle = getResultExtras(true);
26                Toast.makeText(context, "A:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
27                Bundle newBundle = new Bundle();
28                newBundle.putInt(MainActivity.KEY, 80);
29                setResultExtras(newBundle);
30            }
31        }
32    }
33}
34
35// 优先级 0
36public class BReceiver extends BroadcastReceiver {
37    @Override
38    public void onReceive(Context context, Intent intent) {
39        if(intent != null){
40            String action = intent.getAction();
41            if(MainActivity.MY_ACTION.equals(action)){
42                Bundle bundle = getResultExtras(true);
43                Toast.makeText(context, "B:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
44            }
45        }
46    }
47}

无序广播

无序广播指所有与之匹配的广播接收者都能收到广播,没有先后顺序,直到没有广播接收者接收广播为止才会停止广播的传递。

默认情况下有广播发送时,系统会遍历全部APP的Receiver。如果想使得本APP的Receiver不被外界的广播所干扰,可以在Receiver节点添加android:exported=“false"属性,这样系统遍历全部APP清单文件的广播接收者时不会对本App的Receiver进行判断及处理。

本地广播

本地广播仅仅在APP内传播,其他的程序无法收到这个广播。这种广播保证安全性,不会传播到外界。同时由于LocalBroadcastManager不需要用到跨进程机制,因此相对 BroadcastReceiver 而言要更为高效。LocalBroadcastManager只在动态广播时使用,静态广播不能使用LocalBroadcastManager。

1implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'

MainActivity.java

 1public class MainActivity extends AppCompatActivity {
 2    public static final String MY_NEW_ACTION = "cn.tim.action.MY_NEW_ACTION";
 3    
 4    private LocalReceiver localReceiver;
 5    private LocalBroadcastManager localBroadcastManager;
 6
 7    @Override
 8    protected void onCreate(Bundle savedInstanceState) {
 9        super.onCreate(savedInstanceState);
10        setContentView(R.layout.activity_main);
11
12        // 获得LocalBroadcastManager对象
13        localBroadcastManager = LocalBroadcastManager.getInstance(this);
14        // 动态注册广播
15        localReceiver = new LocalReceiver();
16        IntentFilter filter = new IntentFilter();
17        filter.addAction(MY_NEW_ACTION);
18        localBroadcastManager.registerReceiver(localReceiver, filter);
19    }
20
21    public void sendLocalBroadcast(View view) {
22        // 发送本地广播
23        Intent intent = new Intent(MY_NEW_ACTION);
24        localBroadcastManager.sendBroadcast(intent);
25    }
26
27
28    static class LocalReceiver extends BroadcastReceiver {
29        @Override
30        public void onReceive(Context context, Intent intent){
31            Toast.makeText(context,"Received LocalBroadcast!",Toast.LENGTH_SHORT).show();
32        }
33    }
34
35    @Override
36    protected void onDestroy() {
37        super.onDestroy();
38        localBroadcastManager.unregisterReceiver(localReceiver);
39    }
40}

new SDK中使用广播

随着 Android 平台的发展,它会不定期地更改系统广播的行为方式。如果要在Android 7.0(API 级别 24)或更高版本的SDK使用广播,必须注意以下更改:

Android 7.0 API 24

Android 7.0(API 级别 24)及更高版本不发送以下系统广播:

1ACTION_NEW_PICTURE
2ACTION_NEW_VIDEO

此外,以 Android 7.0 及更高版本为目标平台的应用必须使用动态注册的方式,无法在清单中声明广播接收器,所以以后所有广播直接全部使用动态注册的方式吧,如果非要用静态注册的方式,可以发送显式广播,(即指定指定包名再发送,但是我们有时不知道有谁要接收广播,所以显式广播用的比较少),这个时候可以在发送广播的时候携带intent.addFlags(0x01000000); 就能让广播突破隐式广播限制,但是依旧不建议静态注册,还是动态注册比较好。

Android 9.0 API 28

从 Android 9(API 级别 28)开始,NETWORK_STATE_CHANGED_ACTION广播不再接收有关用户位置或个人身份数据的信息。通过 WLAN 接收的系统广播不包含 SSID、BSSID连接信息或扫描结果,如果要获取这些信息,可以调用 WifiManager.getConnectionInfo()。

关于广播的文档可以看这里: 《Receiving broadcasts》