# BLEPeripheralServer.startAdvertising(Object Object)

以 Promise 风格调用:不支持

# 功能描述

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

# 参数

# Object Object

属性类型默认值必填说明
advertiseRequestObject广播自定义参数
结构属性类型默认值必填说明
connectableBooleantrue当前设备是否可连接
deviceNameString广播中 deviceName 字段,默认为空
serviceUuidsArray.<String>要广播的服务 UUID 列表。使用 16/32 位 UUID 时请参考注意事项。
manufacturerDataArray.<Object>广播的制造商信息。仅安卓支持,iOS 因系统限制无法定制。
结构属性类型默认值必填说明
manufacturerIdString制造商ID,0x 开头的十六进制
manufacturerSpecificDataArrayBuffer制造商信息
beaconObject以 beacon 设备形式广播的参数。
结构属性类型默认值必填说明
uuidStringBeacon 设备广播的 UUID
majorNumberBeacon 设备的主 ID
minorNumberBeacon 设备的次 ID
measuredPowerNumber用于判断距离设备 1 米时 RSSI 大小的参考值
powerLevelStringmedium广播功率
合法值说明
low功率低
medium功率适中
high功率高
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

# 注意

  • Android 8.0.9 开始,支持直接使用 16/32/128 位 UUID;
  • Android 8.0.9 以下版本只支持 128 位 UUID,使用 16/32 位的 UUID 时需要进行补位(系统会自动识别是否属于预分配区间)。
  • iOS 必须直接使用 16 位的 UUID,不能补位到 128 位,否则系统组包时仍会按照 128 位传输。iOS 暂不支持 32 位 UUID。
  • iOS 同时只能发起一个广播,安卓支持同时发起多个广播。
  • 传 beacon 参数时,不能同时传入 deviceName,serviceUuids,manufacturerData 参数。