更新记录

V1.0.10(2026-11-09)

安卓端UTS-BLE蓝牙广播


平台兼容性

uni-app(4.0)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - - - - 7.0 - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

LOY-ble-advertiser 示例工程

LOY-ble-advertiser(BLE 广播(外设模式) UTS 插件)的使用示例。

使用方法

  1. 用 HBuilderX 打开本工程(插件已在 uni_modules/LOY-ble-advertiser 中);
  2. 运行菜单 → 运行到手机或模拟器 → 制作自定义调试基座(UTS 插件不能用标准基座);
  3. 制作完成后选择 自定义调试基座 运行到安卓真机;
  4. 点击页面按钮开始/停止广播,用另一台手机的 BLE 调试工具(如 nRF Connect)扫描验证厂商数据(厂商 ID 0x4554)。

注意事项

  • Android 12+ 需在系统设置中授予"附近的设备"权限(BLUETOOTH_ADVERTISE 运行时权限);
  • iOS 系统限制:CoreBluetooth 公开 API 无法广播厂商数据,插件会把指令数据编码进 128 位服务 UUID 广播,接收端固件需支持解析服务 UUID 才能在 iOS 上生效,详见插件 readme。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android: 1. android.permission.BLUETOOTH (Android 11 及以下,蓝牙基础通信) 2. android.permission.BLUETOOTH_ADMIN (Android 11 及以下,蓝牙开关控制) 3. android.permission.BLUETOOTH_ADVERTISE (Android 12+,BLE 广播必需,运行时权限,对应系统设置中的"附近的设备",由使用方 App 在运行时向用户申请) 4. android.permission.ACCESS_FINE_LOCATION (部分安卓系统扫描/广播蓝牙需要定位权限,由使用方 App 申请) 插件本身不申请定位、存储、通讯录等其他任何权限,不弹任何自有弹窗。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据,不连接任何服务器,不发送任何数据到网络。 插件功能完全在设备本地运行:仅通过系统蓝牙接口(Android BluetoothLeAdvertiser)将调用方传入的自定义十六进制数据以 BLE 广播形式发出,数据内容完全由使用方 App 决定,插件不收集、不缓存、不上传任何用户数据、设备信息或广播内容。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无。插件不包含任何广告、SDK 推广或第三方统计组件。

暂无用户评论。