# wx.onBLECharacteristicValueChange(function listener)

基础库 1.1.0 开始支持,低版本需做兼容处理

小程序插件:支持,需要小程序基础库版本不低于 2.9.1

相关文档: 蓝牙低功耗 (BLE)

# 功能描述

监听蓝牙低功耗设备的特征值变化事件。必须先调用 wx.notifyBLECharacteristicValueChange 接口才能接收到设备推送的 notification。

# 参数

# function listener

蓝牙低功耗设备的特征值变化事件的监听函数

# 参数

# Object res
属性 类型 说明
deviceId string 蓝牙设备 id
serviceId string 蓝牙特征对应服务的 UUID
characteristicId string 蓝牙特征的 UUID
value ArrayBuffer 特征最新的值

# 示例代码

在开发者工具中预览效果

// ArrayBuffer转16进制字符串示例
function ab2hex(buffer) {
  let hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function(bit) {
      return ('00' + bit.toString(16)).slice(-2)
    }
  )
  return hexArr.join('');
}
wx.onBLECharacteristicValueChange(function(res) {
  console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)
  console.log(ab2hex(res.value))
})