BroadcastReceiver

云端上的猫
661 阅读8分钟

一. 介绍

广播，是一个全局的监听器，属于Android四大组件之一. 主要用于监听 / 接收 应用 App 发出的广播消息，并 做出响应.

应用场景有:

  • Android不同组件间的通信（含 ：应用内 / 不同应用之间）
  • 多线程通信
  • 与 Android 系统在特定情况下的通信

二. 分类

广播被分为两种不同的类型：“普通广播（Normal broadcasts）”和“有序广播（Ordered broadcasts）”。普通广播是完全异步的，可以在同一时刻（逻辑上）被所有接收者接收到，消息传递的效率比较高，但缺点是：接收者不能将处理结果传递给下一个接收者，并且无法终止广播Intent的传播；然而有序广播是按照接收者声明的优先级别（声明在intent-filter元素的android:priority属性中，数越大优先级别越高,取值范围:-1000到1000。也可以调用IntentFilter对象的setPriority()进行设置），被接收者依次接收广播。如：A的级别高于B,B的级别高于C,那么，广播先传给A，再传给B，最后传给C。A得到广播后，可以往广播里存入数据，当广播传给B时,B可以从广播中得到A存入的数据。

静态注册和动态注册的区别:

1. 静态注册(8.0以后无法使用)
1.无序广播,开发者自身定义 intent的广播（最常用）

  1. 发送方式,显示隐式都可以

      public void normalListener(View view) {
//        Intent intent = new Intent(this, NormalBroadCaseReceiver.class);
//        intent.putExtra("key","broad");
//        sendBroadcast(intent);
        //隐式启动,如果有多个静态注册的广播action 相同,都会收到
//        Intent intent1 = new Intent();
//        intent1.setAction("com.kiwilss.broadcase1");
//        intent1.putExtra("key", "broad");
//        sendBroadcast(intent1);

        //8.0以后,想发送成功就要加上 intent1.setPackage(getPackageName());
        //原因:谷歌在8.0后为了提高效率，删除了静态注册，防止关闭App后广播还在，
        // 造成内存泄漏， 现在静态注册的广播需要指定包名，而动态注册就没有这个问题
        Intent intent1 = new Intent();
        intent1.setAction("com.kiwilss.broadcase1");
        intent1.putExtra("key", "broad");
        intent1.setPackage(getPackageName());
        sendBroadcast(intent1);
    }

  2. 自定义广播

    NormalBroadCaseReceiver

  3. public class NormalBroadCaseReceiver extends BroadcastReceiver {
    @SuppressLint("UnsafeProtectedBroadcastReceiver")
    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e(TAG, "onReceive: "+intent.getStringExtra("key") );
    }
}

    NormalBroadCaseReceiver2

    public class NormalBroadCaseReceiver2 extends BroadcastReceiver {
    @SuppressLint("UnsafeProtectedBroadcastReceiver")
    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e(TAG, "normal2-------onReceive: "+intent.getStringExtra("key") );
    }
}

  4. AndroidManifest.xml里注册

    • 属性说明：
    <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=".mBroadcastReceiver"
//具有相应权限的广播发送者发送的广播才能被此BroadcastReceiver所接收；
    android:permission="string"
//BroadcastReceiver运行所处的进程
//默认为app的进程，可以指定独立的进程
//注：Android四大基本组件都可以通过此属性指定自己的独立进程
    android:process="string" >

//用于指定此广播接收器将接收的广播类型
//本示例中给出的是用于接收网络状态改变时发出的广播
 <intent-filter>
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
    </intent-filter>
</receiver>
    • 注册示例
      <receiver android:name=".broadcastreceiver.NormalBroadCaseReceiver" tools:ignore="ExportedReceiver">
            <intent-filter>
                <action android:name="com.kiwilss.broadcase1"/>
                <category android:name="android.intent.category.DEFAULT"/>
            </intent-filter>
        </receiver>

        <receiver android:name=".broadcastreceiver.NormalBroadCaseReceiver2" tools:ignore="ExportedReceiver">
            <intent-filter>
                <action android:name="com.kiwilss.broadcase1"/>
                <category android:name="android.intent.category.DEFAULT"/>
            </intent-filter>
        </receiver>

    当此 App首次启动时，系统会自动实例化mBroadcastReceiver类，并注册到系统中。

  5. 测试结果

    04-18 15:52:46.360 12305-12305/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: broad 04-18 15:52:46.363 12305-12305/com.kiwilss.lxkj.fourassembly E/MMM: normal2-------onReceive: broad

2.有序广播,静态注册

  1. 发送方法和无序广播类似

    public void orderlyListener(View view) {
    //和无序广播类似
    Intent intent1 = new Intent();
    intent1.setAction("com.kiwilss.broadcase2");
    //intent1.putExtra("key","broad");
    intent1.putExtra("key", "orderly");
    //null 表示没有权限限制
    sendOrderedBroadcast(intent1, null);
}

  2. 自定义广播, 有序广播可以中断传递, 也可以新增传递信息

    OrderlyBroadcastReceiver

    public class OrderlyBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e(TAG, "onReceive: "+intent.getStringExtra("key"));

        if (TextUtils.equals("orderly",intent.getStringExtra("key"))) {
            //中断传递
            abortBroadcast();
        }else {
            //传递新的信息给下一个广播
            Bundle bundle = new Bundle();
            bundle.putString("broad","新的信息");
            setResultExtras(bundle);
        }
    }
}

    OrderlyBroadcastReceiver2

    public class OrderlyBroadcastReceiver2 extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e(TAG, "onReceive22 : "+intent.getStringExtra("key"));

        Bundle bundle = getResultExtras(true);
        String broad = bundle.getString("broad");
        Log.e(TAG, "onReceive222 : "+ broad );
    }
}

  3. 在清单文件中设定优先级

    <!--可以设置广播的优先级-->
<receiver android:name=".broadcastreceiver.OrderlyBroadcastReceiver"
>
    <intent-filter android:priority="100">
        <action android:name="com.kiwilss.broadcase2"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</receiver>
<receiver android:name=".broadcastreceiver.OrderlyBroadcastReceiver2"
>
    <intent-filter android:priority="90">
        <action android:name="com.kiwilss.broadcase2"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</receiver>

4.测试结果

​ 中断传播结果:

​ 04-18 16:23:30.380 15795-15795/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: orderly

新增信息结果:

04-18 16:30:35.026 16342-16342/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: broad 04-18 16:30:35.074 16342-16342/com.kiwilss.lxkj.fourassembly E/MMM: onReceive22 : broad 04-18 16:30:35.074 16342-16342/com.kiwilss.lxkj.fourassembly E/MMM: onReceive222 : 新的信息

3.动态注册

  1. 发送方式

    /**普通广播,动态注册
 * @param view
 */
public void normalDynamicListener(View view) {
    //动态注册广播发送消息
    Intent intent = new Intent("com.kiwilss.normaldynamic");
    intent.putExtra("key","普通广播动态注册");
    sendBroadcast(intent);
}

  2. 注册和解除注册

     @Override
    protected void onResume() {
        super.onResume();
        //普通广播注册
        if (mBroadcastReceiver == null){
            mBroadcastReceiver = new LocalBroadcastReceiver();
            IntentFilter intentFilter = new IntentFilter("com.kiwilss.normaldynamic");
            registerReceiver(mBroadcastReceiver,intentFilter);
        }
    }

@Override
protected void onPause() {
    super.onPause();
    //普通广播解除注册
    if (mBroadcastReceiver != null) {
        unregisterReceiver(mBroadcastReceiver);
    }
}
  • 动态广播最好在Activity 的 onResume()注册、onPause()注销。
  • 原因：
    1. 对于动态广播，有注册就必然得有注销，否则会导致内存泄露
    2. 重复注册、重复注销也不允许

  1. 自定义广播

  2. class LocalBroadcastReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e("MMM", "onReceive: " + intent.getStringExtra("key"));
    }
}

  3. 测试结果

    04-18 16:52:14.730 17989-17989/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: 普通广播动态注册

4. 本地广播 App应用内广播（Local Broadcast）
  1. Android中的广播可以跨App直接通信（exported对于有intent-filter情况下默认值为true）

可能出现的问题：

  • 其他App针对性发出与当前App intent-filter相匹配的广播，由此导致当前App不断接收广播并处理；

  • 其他App注册与当前App一致的intent-filter用于接收广播，获取广播具体信息； 即会出现安全性 & 效率性的问题。

  • 解决方案 使用App应用内广播（Local Broadcast）

    1. App应用内广播可理解为一种局部广播，广播的发送者和接收者都同属于一个App。

    2. 相比于全局广播（普通广播），App应用内广播优势体现在：安全性高 & 效率高

  1. 具体使用

    发送方法:

     /**
     * 对于LocalBroadcastManager方式发送的应用内广播，
     * 只能通过LocalBroadcastManager动态注册，不能静态注册
     *
     * @param view
     */
    public void appListener(View view) {
        //注册应用内广播接收器
        //步骤1：实例化BroadcastReceiver子类 & IntentFilter mBroadcastReceiver
        mBroadcastReceiver = new LocalBroadcastReceiver();
        IntentFilter intentFilter = new IntentFilter();
        //步骤2：实例化LocalBroadcastManager的实例
        localBroadcastManager = LocalBroadcastManager.getInstance(this);
//步骤3：设置接收广播的类型
        intentFilter.addAction("com.kiwilss.local");
//4,注册
        localBroadcastManager.registerReceiver(mBroadcastReceiver, intentFilter);


        //发送应用内广播测试
        Intent intent = new Intent("com.kiwilss.local");
        intent.putExtra("key","本地广播");
        localBroadcastManager.sendBroadcast(intent);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        //取消注册本地广播
        if (mBroadcastReceiver != null)
        localBroadcastManager.unregisterReceiver(mBroadcastReceiver);

        //取消网络监听注册
        if (netBroadcastReceiver != null)
            unregisterReceiver(netBroadcastReceiver);
    }

  2. 自定义广播

  3. class LocalBroadcastReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e("MMM", "onReceive: " + intent.getStringExtra("key"));
    }
}

  4. 测试结果

    04-18 16:57:28.905 17989-17989/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: 本地广播

5.系统广播（System Broadcast）
  1. 介绍

  • 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.ACTION_CLOSE_SYSTEM_DIALOGS
    设备当前设置被改变时(界面语言、设备方向等)Intent.ACTION_CONFIGURATION_CHANGED
    插入耳机时Intent.ACTION_HEADSET_PLUG
    未正确移除SD卡但已取出来时(正确移除方法:设置--SD卡和设备内存--卸载SD卡)Intent.ACTION_MEDIA_BAD_REMOVAL
    插入外部储存装置（如SD卡）Intent.ACTION_MEDIA_CHECKING
    成功安装APKIntent.ACTION_PACKAGE_ADDED
    成功删除APKIntent.ACTION_PACKAGE_REMOVED
    重启设备Intent.ACTION_REBOOT
    屏幕被关闭Intent.ACTION_SCREEN_OFF
    屏幕被打开Intent.ACTION_SCREEN_ON
    关闭系统时Intent.ACTION_SHUTDOWN
    重启设备Intent.ACTION_REBOOT

    注：当使用系统广播时，只需要在注册广播接收者时定义相关的action即可，并不需要手动发送广播，当系统有相关操作时会自动进行系统广播

  1. 使用示例, 监听手机网络状态

    1. 方法

      /**系统广播,示例监听网络
 * @param view
 */
NetBroadcastReceiver netBroadcastReceiver;
public void appDynamicListener(View view) {
     netBroadcastReceiver = new NetBroadcastReceiver();
    IntentFilter intentFilter = new IntentFilter();
    intentFilter.addAction("android.net.conn.CONNECTIVITY_CHANGE");
    registerReceiver(netBroadcastReceiver,intentFilter);
    //ondestory中取消注册
}

    2. 自定义广播

      class NetBroadcastReceiver extends BroadcastReceiver{

    @Override
    public void onReceive(Context context, Intent intent) {
        Log.e("MMM", "onReceive: 网络有变化" );
        //连接或是关闭网络时可以监控
    }
}

    3. 测试, 关闭打开手机网络

      04-18 17:02:03.220 17989-17989/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: 网络有变化 04-18 17:02:06.834 17989-17989/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: 网络有变化 04-18 17:02:13.506 17989-17989/com.kiwilss.lxkj.fourassembly E/MMM: onReceive: 网络有变化

三.动态注册帮助类

鉴于各种限制，尽量使用动态注册，所以写了一个帮助类，方便快速注册和解除注册广播。比较简单，代码如下：

object BroadcastKtx {
    /**
     * 注册广播
     *
     * @param context
     * @param broadcastReceiver
     * @param action
     */
    fun registerBroadcast(
        context: Context?,
        broadcastReceiver: BroadcastReceiver?,
        vararg action: String?
    ) {
        if (context == null || broadcastReceiver == null) return
        val intentFilter = IntentFilter()
        for (element in action) {
            intentFilter.addAction(element)
        }
        context.registerReceiver(broadcastReceiver, intentFilter)
    }

    /**
     * 解除注册广播，广播要和注册时是同一个
     *
     * @param context
     * @param broadcastReceiver
     */
    fun unregisterBroadcast(context: Context?, broadcastReceiver: BroadcastReceiver?) {
        if (context == null || broadcastReceiver == null) return
        context.unregisterReceiver(broadcastReceiver)
    }
}

/**
 * 注册广播
 *
 * @param broadcastReceiver
 * @param action
 */
fun Context?.registerBroadcast(
    broadcastReceiver: BroadcastReceiver?,
    vararg action: String?
) = BroadcastKtx.registerBroadcast(this, broadcastReceiver, *action)

/**
 * 解除注册广播，广播要和注册时是同一个
 *
 * @param broadcastReceiver
 */
fun Context?.unregisterBroadcast(broadcastReceiver: BroadcastReceiver?) =
    BroadcastKtx.unregisterBroadcast(this, broadcastReceiver)


/**
 * 注册广播
 *
 * @param broadcastReceiver
 * @param action
 */
fun Fragment?.registerBroadcast(
    broadcastReceiver: BroadcastReceiver?,
    vararg action: String?
) = BroadcastKtx.registerBroadcast(this?.context, broadcastReceiver, *action)

/**
 * 解除注册广播，广播要和注册时是同一个
 *
 * @param broadcastReceiver
 */
fun Fragment?.unregisterBroadcast(broadcastReceiver: BroadcastReceiver?) =
    BroadcastKtx.unregisterBroadcast(this?.context, broadcastReceiver)

使用很简单，在 Activity/Fragment 中直接使用，示例 demo如下：

class BroadcastActivity: AppCompatActivity(R.layout.activity_broadcast) {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)


       btnSend.setOnClickListener {
            //发送广播信息
           sendBroadcast(createIntentBroadcast(action1,"broad" to "test broadcast"))
       }


    }
    //初始化广播
    val mTestBroadcast by lazy { TestBroadcast() }
    val action1 = "com.kiwilss.broadcase1"
    override fun onResume() {
        super.onResume()
        //注册,可以注册很多个 action
        registerBroadcast(mTestBroadcast,action1)
    }

    override fun onPause() {
        super.onPause()
        unregisterBroadcast(mTestBroadcast)
    }
}

class TestBroadcast: BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        val action = intent?.action
        Log.e("MMM", "onReceive: $action --- ${intent?.getStringExtra("broad")}");
    }
}

四.参考和地址

Android四大组件：BroadcastReceiver史上最全面解析

Android 四大组件

demo

avatar
文章
阅读
粉丝
相关推荐
BroadcastReceiver
963阅读
 · 
36点赞
Android BroadcastReceiver 使用详解
7.6k阅读
 · 
44点赞
Android-BroadcastReceiver
1.2k阅读
 · 
2点赞
Android中BroadcastReceiver详解
3.4k阅读
 · 
4点赞
Android之BroadcastReceiver总结
2.8k阅读
 · 
24点赞
BroadcastReceiver全解析和使用
4.6k阅读
 · 
3点赞
深入理解Android之 BroadcastReceiver
3.2k阅读
 · 
7点赞
Android四大组件之BroadcastReceiver
1.4k阅读
 · 
4点赞
Android 四大组件之 BroadcastReceiver
1.0k阅读
 · 
2点赞

友情链接：