ap.readBLECharacteristicValue(OPTION, CALLBACK)
读取低功耗蓝牙设备特征值中的数据。调用后在 ap.onBLECharacteristicValueChange() 事件中接收数据返回。
OPTION 参数说明
名称 | 类型 | 必填 | 描述 |
---|
deviceId | String | 是 | 蓝牙设备 id,参考 device 对象 |
serviceId | String | 是 | 蓝牙特征值对应 service 的 uuid |
characteristicId | String | 是 | 蓝牙特征值的 uuid |
CALLBACK 参数说明
名称 | 类型 | 描述 |
---|
characteristic | Object | 设备特征值信息 |
characteristic对象
蓝牙设备characteristic(特征值)信息
名称 | 类型 | 描述 |
---|
characteristicId | String | 蓝牙设备特征值的 uuid |
serviceId | String | 蓝牙设备特征值对应服务的 uuid |
value | Hex String | 蓝牙设备特征值的 value |
错误码说明
代码示例
<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.inc.min.js"></script>
<button id="J_btn" class="btn btn-default">读取设备特征值</button>
<script>
var btn = document.querySelector('#J_btn');
btn.addEventListener('click', function(){
ap.readBLECharacteristicValue({
deviceId: 'deviceId',
serviceId: 'serviceId',
characteristicId: 'characteristicId',
success: function(res){
ap.alert('正在读取,请在 ap.onBLECharacteristicValueChange 事件中接收');
},
fail: function(res) {
ap.showToast('读取数据指令失败');
}
});
});
</script>
其他说明
- 设备的特征值必须支持 read 才可以成功调用,具体参照 characteristic 的 properties 属性
- 并行多次调用读写接口存在读写失败的可能性。
- 如果读取超时,错误码 10015,ap.onBLECharacteristicValueChange 接口之后可能返回数据,需要接入方酌情处理。