Loading...
墨滴

kiwilss

2021/07/08  阅读:43  主题:科技蓝

BroadcastReciver

一. 介绍

广播,是一个全局的监听器,属于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);
        }
    }
  • 动态广播最好在ActivityonResume()注册、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
    成功安装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

    注:当使用系统广播时,只需要在注册广播接收者时定义相关的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

kiwilss

2021/07/08  阅读:43  主题:科技蓝

作者介绍

kiwilss