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
错误码说明
error
描述
12
读取数据失败
代码示例
读取设备特征值
var btn = document.querySelector('#J_btn');
btn.addEventListener('click', function(){
ap.readBLECharacteristicValue({
// 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: 'deviceId',
// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
serviceId: 'serviceId',
// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
characteristicId: 'characteristicId',
success: function(res){
ap.alert('正在读取,请在 ap.onBLECharacteristicValueChange 事件中接收');
},
fail: function(res) {
ap.showToast('读取数据指令失败');
}
});
});