wx.onBLECharacteristicValueChange

wx.onBLECharacteristicValueChange(function listener)

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

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

微信 鸿蒙 OS 版：支持

相关文档: 蓝牙低功耗 (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))
})