my.readBLECharacteristicValue

2020-09-15 15:20 更新

版本需求:支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理。支持 iOS 客户端,Android 5.0 及以上版本客户端。

注意: IDE 模拟器暂不支持调试,请以真机调试结果为准。

读取低功耗蓝牙设备特征值中的数据。调用后在 my.onBLECharacteristicValueChange 事件中接收数据返回。

使用说明:

  • 设备的特征值必须支持 read 才可以成功调用,具体请参见 characteristic 的 properties 属性。
  • 并行多次调用读写接口存在读写失败的可能性。
  • 如果读取超时,错误码为 10015,错误码信息及解决方案请参见 蓝牙 API 错误码对照表my.onBLECharacteristicValueChange 接口之后可能返回数据,需要接入方酌情处理。

扫码体验

蓝牙.jpeg

效果示例

蓝牙写入数据.png

示例代码

my.readBLECharacteristicValue({
  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。
success Function 调用成功的回调函数。
fail Function 调用失败的回调函数。
complete Function 调用结束的回调函数(调用成功、失败都会执行)。

success 回调函数

入参为 Object 类型,属性如下:

属性 类型 描述
characteristic Object 设备特征值信息

characteristic 对象

蓝牙设备 characteristic(特征值)信息。

名称 类型 描述
characteristicId String 蓝牙设备特征值的 UUID。
serviceId String 蓝牙设备特征值对应服务的 UUID。
value Hex String 蓝牙设备特征值的 value。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号