Version: next
Taro.getBLEDeviceCharacteristics(option)
获取蓝牙设备某个服务中所有特征值(characteristic)。
类型
(option: Option) => Promise<SuccessCallbackResult>
参数
Option
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| deviceId | string | 是 | 蓝牙设备 id |
| serviceId | string | 是 | 蓝牙服务 uuid，需要使用 getBLEDeviceServices |
| complete | (res: BluetoothError) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| fail | (res: BluetoothError) => void | 否 | 接口调用失败的回调函数 |
| success | (res: SuccessCallbackResult) => void | 否 | 接口调用成功的回调函数 |
SuccessCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| characteristics | BLECharacteristic[] | 设备特征值列表 |
| errMsg | string | 成功：ok，错误：详细信息 |
BLECharacteristic
设备特征值列表
| 参数 | 类型 | 说明 |
|---|---|---|
| properties | Properties | 该特征值支持的操作类型 |
| uuid | string | 蓝牙设备特征值的 uuid |
Properties
该特征值支持的操作类型
| 参数 | 类型 | 说明 |
|---|---|---|
| indicate | boolean | 该特征值是否支持 indicate 操作 |
| notify | boolean | 该特征值是否支持 notify 操作 |
| read | boolean | 该特征值是否支持 read 操作 |
| write | boolean | 该特征值是否支持 write 操作 |
示例代码
Taro.getBLEDeviceCharacteristics({
// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
deviceId,
// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
serviceId,
success: function (res) {
console.log('device getBLEDeviceCharacteristics:', res.characteristics)
}
})
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| Taro.getBLEDeviceCharacteristics | ✔️ |