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 方式。

扫码体验

蓝牙.jpeg

效果示例

蓝牙写入数据.png

示例代码

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 调用结束的回调函数(调用成功、失败都会执行)。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号