my.readblecharacteristicvalue(object object)
支付宝客户端 10.0.18 或更高版本； 若版本较低，建议采取 兼容处理 。
小程序开发者工具： 不支持。请以真机调试结果为准。
主体： 企业支付宝小程序 、 个人支付宝小程序
读取低功耗蓝牙设备特征中的数据
此 api 调用成功后，除了触发 success 回调外，也会触发 blecharacteristicvaluechange 事件（即触发 my.onblecharacteristicvaluechange() 注册的监听函数），即使特征值相比之前并未发生变化
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| deviceid | string | - | 是 | 蓝牙设备 id。该 deviceid 对应的蓝牙设备需要已经通过 my.connectbledevice 建立连接 |
| serviceid | string | - | 是 | 蓝牙服务的 uuid。可调用 my.getbledeviceservices 获取 |
| characteristicid | string | - | 是 | 蓝牙特征的 uuid，该值的 properties（属性）中 read 值必须是 true。可调用 my.getbledevicecharacteristics 获取 |
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
success 回调函数
参数
object res
查看示例
| 属性 | 类型 | 描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| characteristic | object | 设备特征值信息 |
||||||||||
|
fail 回调的参数为 object，error 属性为错误码，errormessage属性为错误消息。
错误码的详细信息请查看蓝牙 api 错误码对照表。
<view>
<button ontap="readblecharacteristicvalue">读取特征数据button>
view>
page({
data: {
// 本示例值为假数据,实际开发中 deviceid 可使用 my.startbluetoothdevicesdiscovery api 和 my.onbluetoothdevicefound api 去获取。
deviceid: "55829650-fb8a-4c86-1f80-d8dec4dfdc5d",
// 本示例值为假数据,实际开发中 serviceid 可在 my.getbledeviceservices 接口中获取。
serviceid: "44:90:bb:99:41:a5",
// 本示例值为假数据,实际开发中 characteristicid 可在 my.getbledevicecharacteristics 接口中获取。
characteristicid: "2a19"
},
// 读取设备特征值中的数据
readblecharacteristicvalue() {
my.readblecharacteristicvalue({
deviceid: this.data.deviceid,
serviceid: this.data.serviceid,
characteristicid: this.data.characteristicid,
success: (res) => {
console.log(res);
},
fail: (error) => {
console.log(error);
},
});
},
});
-
tip并行调用多次读接口存在读失败的可能性。