Skip to main content
Version: 2.x

Taro.getBLEDeviceCharacteristics(option)

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

参考文档

类型

(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 操作

示例代码

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

API 支持度

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