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微信小程序H5React Native
Taro.getBLEDeviceCharacteristics✔️