tap.getBLEDeviceCharacteristics(Object object)

以 Promise 风格调用：支持

功能描述

获取蓝牙低功耗设备对应服务中所有特征 (characteristic)。

参数

Object object

属性	类型	默认值	必填	说明
deviceId	string		是	蓝牙设备 id。需要已经通过 tap.createBLEConnection 建立连接
serviceId	string		是	蓝牙服务 UUID。需要先调用 tap.getBLEDeviceServices 获取
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

	属性	类型	说明
	characteristics	Array.<Object>	设备特征列表
	结构属性 类型 说明 uuid string 蓝牙设备特征的 UUID properties Object 该特征支持的操作类型 结构属性 类型 说明 read boolean 该特征是否支持 read 操作 write boolean 该特征是否支持 write 操作 notify boolean 该特征是否支持 notify 操作 indicate boolean 该特征是否支持 indicate 操作 writeNoResponse boolean 该特征是否支持无回复写操作 writeDefault boolean 该特征是否支持有回复写操作

错误

错误码	错误信息	说明
0	ok	正常
-1	already connect	已连接
10000	not init	未初始化蓝牙适配器
10001	not available	当前蓝牙适配器不可用
10002	no device	没有找到指定设备
10003	connection fail	连接失败
10004	no service	没有找到指定服务
10005	no characteristic	没有找到指定特征
10006	no connection	当前连接已断开
10007	property not support	当前特征不支持此操作
10008	system error	其余所有系统上报的异常
10009	system not support	Android 系统特有，系统版本低于 4.3 不支持 BLE
10012	operate time out	连接超时
10013	invalid_data	连接 deviceId 为空或者是格式不正确

示例代码

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