getBLEDeviceCharacteristics
描述
获取读写特征
网页应用需要完成鉴权后调用该接口。
支持说明
| 客户端平台 | WPS协作版本要求 |
|---|---|
| iOS | >=5.23.0 |
| Android | >=5.23.0 |
输入
| 名称 | 数据类型 | 是否必填 | 描述 |
|---|---|---|---|
| params | object | 是 | |
| ∟ deviceId | string | 是 | 蓝牙设备 ID 示例值：E5:66:9F:82:46:61 |
| ∟ serviceId | string | 是 | 蓝牙特征值对应service的uuid 示例值：FF:24:79:5D:6D:0C |
输出
| 名称 | 类型 | 描述 |
|---|---|---|
| characteristics | array<object> | 设备特征值信息 |
| ∟ characteristicId | string | 蓝牙设备特征值的 UUID |
| ∟ properties | object | 该特征值支持的操作类型 |
| ∟ ∟ indicate | boolean | 该特征值是否支持 indicate 操作 |
| ∟ ∟ notify | boolean | 该特征值是否支持 notify 操作 |
| ∟ ∟ read | boolean | 该特征值是否支持 read 操作 |
| ∟ ∟ write | boolean | 该特征值是否支持 write 操作 |
| ∟ serviceId | string | 蓝牙设备特征值对应服务的 UUID |
| ∟ value | string | 蓝牙设备特征值的value |
示例代码
ts
const params = {
deviceId: "E5:66:9F:82:46:61",
serviceId: "FF:24:79:5D:6D:0C",
}
window.ksoxz_sdk.getBLEDeviceCharacteristics({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 | 没有找到指定服务 |
除以上错误外，还可能存在公共错误，参考：公共错误码