# wx.onBLECharacteristicValueChange(function listener)

> 基础库 1.1.0 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.9.1](1003706)
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [蓝牙低功耗 (BLE)](/minigame/dev/guide/device/ble.md)

## 功能描述

监听蓝牙低功耗设备的特征值变化事件。必须先调用 [wx.notifyBLECharacteristicValueChange](/minigame/dev/api/device/bluetooth-ble/wx.notifyBLECharacteristicValueChange) 接口才能接收到设备推送的 notification。

## 参数

### function listener

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

#### 参数

##### Object res

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

## 示例代码

[在开发者工具中预览效果](https://developers.weixin.qq.com/s/pQU51zmz7a3K)

```js
// 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))
})
```