my.onblecharacteristicvaluechange(function listener)
支付宝客户端 10.0.18 或更高版本; 若版本较低,建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具: 不支持。请使用真机调试。
主体: 企业支付宝小程序 、 个人支付宝小程序
监听低功耗蓝牙设备的特征值变化事件。
有两种情况会触发 blecharacteristicvaluechange 事件:
- 调用 my.notifyblecharacteristicvaluechange 启用低功耗蓝牙设备特征值变化时的通知功能后,设备的特征值发生变化,会触发 blecharacteristicvaluechange;
- 调用 my.readblecharacteristicvalue 成功读取设备特征值后,除了触发其 success 回调,也会触发 blecharacteristicvaluechange(特征值相比之前不一定发生了变化)
function listener
蓝牙低功耗设备的特征值变化的事件的监听函数
参数
object res
查看示例
属性 | 类型 | 描述 |
---|---|---|
deviceid | string | 蓝牙设备 id。该 deviceid 对应的蓝牙设备需要已经通过 my.connectbledevice 建立连接 |
serviceid | string | 蓝牙服务的 uuid。可调用 my.getbledeviceservices 获取 |
characteristicid | string | 蓝牙特征的 uuid。可调用 my.getbledevicecharacteristics 获取 |
value | string | 蓝牙设备特征的值。该值为16进制字符串(hex string)例如:'e7070f1516223402120' |
my.onblecharacteristicvaluechange js 代码
my.onblecharacteristicvaluechange((res)=>{
console.log(res)
});
-
tip该 api 每次调用都会注册一次监听,而非覆盖上一次监听。所以为防止多次监听导致一次事件产生多次回调的情况,建议每次调用 my.onblecharacteristicvaluechange 方法监听事件之前,先调用 my.offblecharacteristicvaluechange 方法,关闭之前的事件监听。