my.notifyBLECharacteristicValueChange
2020-09-15 15:20 更新
版本需求:支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理。支持 iOS 客户端,Android 5.0 及以上版本客户端。
注意:IDE 模拟器暂不支持调试,请以真机调试结果为准。
启用低功耗蓝牙设备特征值变化时的 notify 功能。
使用说明:
- 设备的特征值必须支持 notify/indicate 才可以成功调用,具体可参照 characteristic(特征值)的 properties 属性。
- 必须先启用 notify 才能监听到设备特征值变化的 notify 功能事件。
- 订阅操作成功后需要设备主动更新特征值的 value,才会触发 my.onBLECharacteristicValueChange 。
- 订阅方式效率比较高,推荐使用订阅代替 read 方式。
扫码体验
效果示例
示例代码
my.notifyBLECharacteristicValueChange({
deviceId: deviceId,
serviceId: serviceId,
characteristicId: characteristicId,
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
入参
Object 类型,属性如下:
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
deviceId | String | 是 | 蓝牙设备 ID,参考 device 对象。 |
serviceId | String | 是 | 蓝牙特征值对应 service 的 UUID。 |
characteristicId | String | 是 | 蓝牙特征值的 UUID。 |
descriptorId | String | 否 | notify 的 descriptor 的 UUID(Android 系统特有,默认值为 00002902-0000-10008000-00805f9b34fb)。 |
state | Boolean | 否 | 是否启用 notify 或 indicate。(注意:此参数从支付宝客户端 10.0.20 开始支持)。 |
success | Function | 否 | 调用成功的回调函数。 |
fail | Function | 否 | 调用失败的回调函数。 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行)。 |
以上内容是否对您有帮助:
更多建议: