赛捷软件论坛's Archiver

vicky.yu 发表于 2026-6-9 10:44

wx.readBLECharacteristicValue(OBJECT)

读取低功耗蓝牙设备的特征值的二进制数据值。注意:必须设备的特征值支持read才可以成功调用,具体参照 characteristic 的 properties 属性

OBJECT参数说明:

参数        类型        必填        说明
deviceId        string        是        蓝牙设备 id,参考 device 对象
serviceId        string        是        蓝牙特征值对应服务的 uuid
characteristicId        string        是        蓝牙特征值的 uuid
success        Function        是        成功则返回本机蓝牙适配器状态
fail        Function        否        接口调用失败的回调函数
complete        Function        否        接口调用结束的回调函数(调用成功、失败都会执行)
success返回参数:

参数        类型        说明
characteristic        object        设备特征值信息
errMsg        string        成功:ok,错误:详细信息
characteristic对象

蓝牙设备characteristic(特征值)信息

参数        类型        说明
characteristicId        string        蓝牙设备特征值的 uuid
serviceId        object        蓝牙设备特征值对应服务的 uuid
value        ArrayBuffer        蓝牙设备特征值对应的二进制值(注意:vConsole 无法打印出 ArrayBuffer 类型数据)
示例代码:

// 必须在这里的回调才能获取
wx.onBLECharacteristicValueChange(function(characteristic) {
  console.log('characteristic value comed:', characteristic)
})

wx.readBLECharacteristicValue({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  success: function (res) {
    console.log('readBLECharacteristicValue:', res.characteristic.value)
  }
})

页: [1]

Powered by Discuz! Archiver 7.2  © 2001-2009 Comsenz Inc.