my.readBLECharacteristicValue
2020-09-15 15:20 更新
版本需求:支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理。支持 iOS 客户端,Android 5.0 及以上版本客户端。
注意: IDE 模拟器暂不支持调试,请以真机调试结果为准。
读取低功耗蓝牙设备特征值中的数据。调用后在 my.onBLECharacteristicValueChange 事件中接收数据返回。
使用说明:
- 设备的特征值必须支持 read 才可以成功调用,具体请参见 characteristic 的 properties 属性。
- 并行多次调用读写接口存在读写失败的可能性。
- 如果读取超时,错误码为 10015,错误码信息及解决方案请参见 蓝牙 API 错误码对照表。my.onBLECharacteristicValueChange 接口之后可能返回数据,需要接入方酌情处理。
扫码体验
效果示例
示例代码
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。 |
以上内容是否对您有帮助:
更多建议: