如何使用 wx.onBLECharacteristicValueChange 监听蓝牙设备特征值变化事件？

推荐答案

wx.onBLECharacteristicValueChange(function(res) {
  console.log('特征值变化:', res);
  // 处理特征值变化的逻辑
});

本题详细解读

1. 功能介绍

wx.onBLECharacteristicValueChange 是微信小程序提供的 API，用于监听蓝牙设备特征值的变化。当蓝牙设备的特征值发生变化时，会触发该事件，并返回变化后的特征值数据。

2. 参数说明

• res：回调函数的参数，包含以下属性：
  • deviceId：蓝牙设备 ID。
  • serviceId：蓝牙服务 UUID。
  • characteristicId：蓝牙特征值 UUID。
  • value：特征值的最新数据（ArrayBuffer 类型）。

3. 使用场景

该 API 通常用于需要实时获取蓝牙设备数据的场景，例如心率监测、传感器数据采集等。通过监听特征值的变化，可以及时获取设备的最新状态或数据。

4. 注意事项

• 在使用 wx.onBLECharacteristicValueChange 之前，必须先通过 wx.notifyBLECharacteristicValueChange 启用特征值的通知功能。
• 监听事件后，确保在不需要时调用 wx.offBLECharacteristicValueChange 取消监听，以避免不必要的资源消耗。

5. 示例代码

// www.javascriptcn.com code example
// 启用特征值通知
wx.notifyBLECharacteristicValueChange({
  deviceId: deviceId,
  serviceId: serviceId,
  characteristicId: characteristicId,
  state: true,
  success(res) {
    console.log('启用通知成功');
  }
});

// 监听特征值变化
wx.onBLECharacteristicValueChange(function(res) {
  console.log('特征值变化:', res);
  // 处理特征值变化的逻辑
});

通过以上代码，你可以成功监听蓝牙设备特征值的变化，并在变化时执行相应的逻辑处理。