title: Taro.getBLEDeviceCharacteristics(option)

sidebar_label: getBLEDeviceCharacteristics

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

支持情况：getBLEDeviceCharacteristics - 图1 getBLEDeviceCharacteristics - 图2 getBLEDeviceCharacteristics - 图3

参考文档

类型

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

参数

参数 类型
option Option

Option

参数 类型 必填 说明
deviceId string 是 蓝牙设备 id
serviceId string 是 蓝牙服务 uuid，需要使用 getBLEDeviceServices 获取
complete (res: TaroGeneral.BluetoothError) => void 否 接口调用结束的回调函数（调用成功、失败都会执行）
fail (res: TaroGeneral.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 操作

示例代码

  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. })