readBLECharacteristicValue
描述
读取蓝牙接口数据
网页应用需要完成鉴权后调用该接口。
设备的特征值必须支持read才可以成功调用，具体参照getBLEDeviceCharacteristics输出的
properties 属性。
支持说明
| 客户端平台 | WPS协作版本要求 |
|---|---|
| iOS | >=5.23.0 |
| Android | >=5.23.0 |
输入
| 名称 | 数据类型 | 是否必填 | 描述 |
|---|---|---|---|
| params | object | 是 | |
| ∟ characteristicId | string | 是 | 蓝牙特征值的 uuid |
| ∟ deviceId | string | 是 | 蓝牙设备 ID 示例值：E5:66:9F:82:46:61 |
| ∟ serviceId | string | 是 | 蓝牙特征值对应 service 的 uuid |
| onSuccess | Function | 否 | |
| onError | Function | 否 |
输出
| 名称 | 类型 | 描述 |
|---|---|---|
| characteristic | array<object> | 设备特征值信息 |
| ∟ characteristicId | string | 蓝牙设备特征值的 uuid |
| ∟ serviceId | string | 蓝牙设备特征值对应服务的 uuid |
| ∟ value | string | 蓝牙设备特征值的value |
示例代码
ts
const params = {
deviceId: 'E5:66:9F:82:46:61',
serviceId: 'FF:24:79:5D:6D:0C',
characteristicId: 'FF:24:79:5D:6D:0C'
}
window.ksoxz_sdk.readBLECharacteristicValue({params,onSuccess,onError})错误码
| errno | msg | 含义 |
|---|---|---|
| 1022103 | Bluetooth is disabled | 蓝牙未打开 |
| 1502001 | Bluetooth adapter not initialized | 蓝牙适配器未初始化 |
| 1502014 | Bluetooth device is not connected | 该 ID 对应的蓝牙设备未连接 |
| 1502010 | Service not found | 没有找到指定服务 |
| 1502011 | Characteristic not found | 没有找到指定特征 |
| 1502012 | property not support | 当前特征不支持此操作 |
除以上错误外，还可能存在公共错误，参考：公共错误码