BLEPeripheralServer.startAdvertising(Object Object)

基础库 2.10.3 开始支持,低版本需做兼容处理

Promise 风格 调用:不支持

小程序插件:不支持

开始广播本地创建的外围设备。

参数

Object Object

属性 类型 默认值 必填 说明
advertiseRequest Object 广播自定义参数
powerLevel String medium 广播功率
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

Object.advertiseRequest 的结构

属性 类型 默认值 必填 说明
connectable Boolean true 当前 service 是否可连接
deviceName String 广播中 deviceName 字段,默认为空
serviceUuids Array.<String> 要广播的服务 UUID 列表,需要先通过 addService 添加。使用 16/32 位 UUID 时请参考注意事项。
manufacturerData Array.<Object> 广播的制造商信息。仅安卓支持,iOS 因系统限制无法定制。

manufacturerData 的结构

属性 类型 默认值 必填 说明
manufacturerId String 制造商ID,0x 开头的十六进制
manufacturerSpecificData ArrayBuffer 制造商信息

Object.powerLevel 的合法值

说明 最低版本
low 功率低
medium 功率适中
high 功率高

注意

  • Android 目前只支持 128 位 UUID,但是会自动识别 128 位 UUID 是否属于预分配区间。如果使用 16/32 位的 UUID 时需要开发者进行补位,可以参考蓝牙指南
  • iOS 必须直接使用 16 位的 UUID,不能补位到 128 位,否则系统组包时仍会按照 128 位传输。iOS 暂不支持 32 位 UUID。