该 API 使用方法为 wx.onBLEPeripheralConnectionStateChanged(function listener)。
属性 | 类型 | 说明 |
deviceId | String | 连接状态变化的设备 id |
serverId | String | server 的 UUID |
connected | Boolean | 连接目前状态 |
该 API 使用方法为 wx.offBLEPeripheralConnectionStateChanged(function listener)
const listener = function (res) { console.log(res) }wx.onBLEPeripheralConnectionStateChanged(listener)wx.offBLEPeripheralConnectionStateChanged(listener) // 需传入与监听时同一个的函数对象
该 API 使用方法为 wx.createBLEPeripheralServer(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
属性 | 类型 | 说明 |
server | BLEPeripheralServer | 外围设备的服务端 |
该 方法 使用方式为 BLEPeripheralServer.addService(Object object)
属性 | 类型 | 必填 | 说明 |
service | Object | 是 | 描述service的Object |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
结构属性 | 类型 | 必填 | 说明 |
uuid | string | 是 | 蓝牙服务的 UUID |
characteristics | Array.<Object> | 是 | characteristics 列表 |
结构属性 | 类型 | 必填 | 说明 |
uuid | string | 是 | characteristic 的 UUID |
properties | Object | 否 | 特征支持的操作 |
permission | Object | 否 | 特征权限 |
value | Array.<Object> | 否 | 特征对应的二进制值 |
descriptors | Array.<Object> | 否 | 描述符数据 |
结构属性 | 类型 | 默认值 | 必填 | 说明 |
write | boolean | false | 否 | 写 |
writeNoResponse | boolean | false | 否 | 无回复写 |
read | boolean | false | 否 | 读 |
notify | boolean | false | 否 | 订阅 |
indicate | boolean | false | 否 | 回包 |
结构属性 | 类型 | 默认值 | 必填 | 说明 |
readable | boolean | false | 否 | 可读 |
writeable | boolean | false | 否 | 可写 |
readEncryptionRequired | boolean | false | 否 | 加密读请求 |
writeEncryptionRequired | boolean | false | 否 | 加密写请求 |
结构属性 | 类型 | 必填 | 说明 |
uuid | string | 是 | Descriptors 的 UUID |
permission | Object | 否 | 描述符的权限 |
value | ArrayBuffer | 否 | 描述符数据 |
结构属性 | 类型 | 默认值 | 必填 | 说明 |
write | boolean | false | 否 | 写 |
read | boolean | false | 否 | 读 |
该 方法 使用方式为 BLEPeripheralServer.removeService(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
serviceId | String | - | 是 | service 的 UUID |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
该 方法 使用方式为 BLEPeripheralServer.startAdvertising(Object Object)
属性 | 类型 | 默认值 | 必填 | 说明 |
advertiseRequest | object | - | 是 | 广播自定义参数 |
powerLevel | string | medium | 否 | 广播功率，合法值为 low：功率低 medium：功率适中 high：功率高 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
结构属性 | 类型 | 默认值 | 必填 | 说明 |
connectable | boolean | true | 否 | 当前设备是否可连接 |
deviceName | string | - | 否 | 广播中 deviceName 字段，默认为空 |
serviceUuids | Array.<string> | - | 否 | 要广播的服务 UUID 列表。使用 16/32 位 UUID 时请参考注意事项 |
manufactureData | Array.<Object> | - | 否 | 广播的制造商信息。仅 Android 支持，iOS 因系统限制无法定制 |
beacon | object | - | 否 | 以 beacon 设备形式广播的参数 |
结构属性 | 类型 | 必填 | 说明 |
manufacturerId | String | 是 | 制造商ID，0x 开头的十六进制 |
manufacturerSpecificData | ArrayBuffer | 否 | 制造商信息 |
结构属性 | 类型 | 必填 | 说明 |
uuid | number | 是 | Beacon 设备广播的 UUID |
major | number | 是 | Beacon 设备的主 ID |
minor | number | 是 | Beacon 设备的次 ID |
measurePower | number | 是 | 用于判断距离设备 1 米时 RSSI 大小的参考值 |
该 方法 使用方式为 BLEPeripheralServer.stopAdvertising()
属性 | 类型 | 默认值 | 必填 | 说明 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
该 方法 使用方式为 BLEPeripheralServer.writeCharacteristicValue(Object Object)
属性 | 类型 | 默认值 | 必填 | 说明 |
serviceId | string | - | 是 | 蓝牙特征对应服务的 UUID |
characteristicId | string | - | 是 | 蓝牙特征的 UUID |
value | ArrayBuffer | - | 是 | characteristic 对应的二进制值 |
needNotify | boolean | - | 是 | 是否需要通知主机 value 已更新 |
callbackId | number | - | 否 | 可选，处理回包时使用 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
该 方法 使用方式为 BLEPeripheralServer.onCharacteristicWriteRequest(function listener)
属性 | 类型 | 说明 |
serviceId | String | 蓝牙特征对应服务的 UUID |
characteristicId | String | 蓝牙特征的 UUID |
callbackId | Number | |
value | ArrayBuffer | 请求写入特征的二进制数据值 |
该 方法 使用方式为 BLEPeripheralServer.offCharacteristicWriteRequest(function listener)
const listener = function (res) { console.log(res) }BLEPeripheralServer.onCharacteristicWriteRequest(listener)BLEPeripheralServer.offCharacteristicWriteRequest(listener) // 需传入与监听时同一个的函数对象
该 方法 使用方式为 BLEPeripheralServer.onCharacteristicReadRequest(function listener)
属性 | 类型 | 说明 |
serviceId | String | 蓝牙特征对应服务的 UUID |
characteristicId | String | 蓝牙特征的 UUID |
callbackId | Number |
该 方法 使用方式为 BLEPeripheralServer.offCharacteristicReadRequest(function listener)
const listener = function (res) { console.log(res) }BLEPeripheralServer.onCharacteristicReadRequest(listener)BLEPeripheralServer.offCharacteristicReadRequest(listener) // 需传入与监听时同一个的函数对象
该 方法 使用方式为 BLEPeripheralServer.onCharacteristicSubscribed(function listener)
属性 | 类型 | 说明 |
serviceId | String | 蓝牙特征对应服务的 UUID |
characteristicId | String | 蓝牙特征的 UUID |
该 方法 使用方式为 BLEPeripheralServer.offCharacteristicSubscribed(function listener)
const listener = function (res) { console.log(res) }BLEPeripheralServer.onCharacteristicSubscribed(listener)BLEPeripheralServer.offCharacteristicSubscribed(listener) // 需传入与监听时同一个的函数对象
该 方法 使用方式为 BLEPeripheralServer.onCharacteristicUnsubscribed(function listener)
属性 | 类型 | 说明 |
serviceId | String | 蓝牙特征对应服务的 UUID |
characteristicId | String | 蓝牙特征的 UUID |
该 方法 使用方式为 BLEPeripheralServer.offCharacteristicUnsubscribed(function listener)
const listener = function (res) { console.log(res) }BLEPeripheralServer.onCharacteristicUnsubscribed(listener)BLEPeripheralServer.offCharacteristicUnsubscribed(listener) // 需传入与监听时同一个的函数对象
文档反馈