获取蓝牙设备某个服务中所有特征值(characteristic)。

参考文档

类型

  1. (option: Option) => Promise<SuccessCallbackResult>

参数

Option

参数类型必填说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙服务 uuid,需要使用 getBLEDeviceServices 获取
complete(res: BluetoothError) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: BluetoothError) => void接口调用失败的回调函数
success(res: SuccessCallbackResult) => void接口调用成功的回调函数

SuccessCallbackResult

参数类型说明
characteristicsBLECharacteristic[]设备特征值列表
errMsgstring成功:ok,错误:详细信息

BLECharacteristic

设备特征值列表

参数类型说明
propertiesProperties该特征值支持的操作类型
uuidstring蓝牙设备特征值的 uuid

Properties

该特征值支持的操作类型

参数类型说明
indicateboolean该特征值是否支持 indicate 操作
notifyboolean该特征值是否支持 notify 操作
readboolean该特征值是否支持 read 操作
writeboolean该特征值是否支持 write 操作

示例代码

  1. Taro.getBLEDeviceCharacteristics({
  2. // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  3. deviceId,
  4. // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
  5. serviceId,
  6. success: function (res) {
  7. console.log('device getBLEDeviceCharacteristics:', res.characteristics)
  8. }
  9. })

API 支持度

API微信小程序H5React Native
Taro.getBLEDeviceCharacteristics✔️