uniapp 系统广播、自定义广播插件 Ba-Broadcast

三杯五岳

已于 2022-12-01 18:01:59 修改

阅读量2.7k

点赞数

分类专栏： uni-app 文章标签： uni-app 监听广播系统广播发送广播自定义广播

于 2022-12-01 17:31:53 首次发布

本文链接：https://blog.csdn.net/u013164293/article/details/128107656

版权

uni-app 专栏收录该内容

65 篇文章 27 订阅

订阅专栏

简介（下载地址）

Ba-Broadcast 是一款可监听系统广播的uniapp插件，如息屏、亮屏、声音、电量等等。支持监听系统广播；支持自定义广播；支持发送广播。

支持系统广播（支持设备支持的所有广播配置，支持系统参数原路返回）
支持自定义广播（参数可随意自定义，可多个）
支持发送广播
如有特殊，可联系作者定制

截图展示

在这里插入图片描述

使用方法

引用

在 script 中引入组件

	const broadcast = uni.requireNativePlugin('Ba-Broadcast')

示例

可在页面 script 中调用（示例参考，可根据自己业务和调用方法自行修改）

<script>
	const broadcast = uni.requireNativePlugin('Ba-Broadcast')
	export default {
		data() {
			return {
				msgList: [],
				actions: [
					'android.intent.action.SCREEN_OFF', //关闭屏幕
					'android.intent.action.SCREEN_ON', //打开屏幕
					'android.intent.action.USER_PRESENT', //解锁屏幕
					'com.ba.temp.action', //自定义广播
				],
				action: 'com.ba.temp.action',
				msg: '测试参数'
			}
		},
		methods: {
			register() { //注册监听
				broadcast.register({
					actions: this.actions
				}, res => {
					console.log(res);
					let msg = '';
					if (res.msg) {
						msg = res.msg;
					}
					if (res.action) { //判断是否是接收到广播消息
						this.msgList.push(res.action);
						msg = res.action;
					} else if (res.ok) {
	
					}
					uni.showToast({
						title: msg,
						icon: "none",
						duration: 3000
					})
				});
			},
			unregister() { //注销监听
				broadcast.unregister({}, res => {
					console.log(res);
					uni.showToast({
						title: res.msg,
						icon: "none",
						duration: 3000
					})
				});
			},
			sendBroadcast() { //发送自定义广播
				if (!this.action) {
					uni.showToast({
						title: 'action 不能为空',
						icon: "none"
					})
					return
				}
				broadcast.sendBroadcast({
					action: this.action, //广播 action
					msg: this.msg, //随意自定义参数，可多个
				}, res => {
					console.log(res);
					uni.showToast({
						title: res.msg,
						icon: "none",
						duration: 3000
					})
				});
			},
		}
	}
</script>

系统广播清单

这里列出了一些常用的系统广播清单，系统所有的广播都可支持，参数返回和系统一致

常用广播清单
action	说明	参数名	说明
android.intent.action.SCREEN_OFF	关闭屏幕
android.intent.action.SCREEN_ON	打开屏幕
android.intent.action.USER_PRESENT	解锁屏幕
android.intent.action.REBOOT	重启设备
android.intent.action.ACTION_SHUTDOWN	关闭系统
android.intent.action.CLOSE_SYSTEM_DIALOGS	用户点击home键（homekey）和多任务键（recentapps）时（返回的reason值会有区别）、当屏幕超时进行锁屏时、当用户按下电源按钮、进行锁屏时
android.intent.action.ACTION_POWER_CONNECTED	插上外部电源时发出的广播
android.intent.action.ACTION_POWER_DISCONNECTED	已断开外部电源链接时发出的广播
android.intent.action.BATTERY_CHANGED	充电状态，或者电池的电量发生变化
android.intent.action.BATTERY_LOW	电池电量低
android.intent.action.BATTERY_OKAY	电池电量充足，即从电池电量低变化到饱满时会发出广播
android.intent.action.AIRPLANE_MODE	关闭或打开飞行模式时的广播	state	1：打开 0：关闭
android.intent.action.HEADSET_PLUG	在耳机口上插入耳机时发出的广播	state	1：插入 0：拔出
android.provider.Telephony.SMS_RECEIVE	接收短信需要对应权限 android.permission.RECEIVE_SMS
android.media.VOLUME_CHANGED_ACTION	音量改变
android.intent.action.TIME_TICK	当前时间变化（正常的时间流逝）。当前时间改变，每分钟都发送
android.intent.action.PACKAGE_INSTALL	触发一个下载而且完成安装时发出的广播，好比在电子市场里下载应用
android.intent.action.PACKAGE_REMOVED	成功的删除某个APK以后发出的广播（正在被安装的包程序不能接收到这个广播）
android.intent.action.PACKAGE_REPLACED	替换一个现有的安装包时发出的广播（无论如今安装的APP比以前的新仍是旧，都会发出此广播）
android.intent.action.PACKAGE_ADDED	成功的安装APK以后
android.intent.action.PACKAGE_CHANGED	一个已存在的应用程序包已经改变，包括包名
android.intent.action.PACKAGE_DATA_CLEARED	清除一个应用程序的数据时发出的广播(在设置－－应用管理－－选中某个应用，以后点清除数据时?)

方法清单

名称	说明
register	注册监听
unregister	注销监听
sendBroadcast	发送自定义广播

register 方法参数

注册监听广播

属性名	类型	必填	默认值	说明
actions	Array	true	‘’	需要监听的广播，必填，可参考本文的“系统广播”，也可自行配置其他系统支持的广播，或自定义广播