如何使用 wx.notifyBLECharacteristicValueChange 启用蓝牙设备特征值的 notify 功能？

推荐答案

// www.javascriptcn.com code example
wx.notifyBLECharacteristicValueChange({
  deviceId: '设备ID', // 蓝牙设备ID
  serviceId: '服务UUID', // 蓝牙服务UUID
  characteristicId: '特征值UUID', // 蓝牙特征值UUID
  state: true, // 启用notify功能
  success(res) {
    console.log('启用notify成功', res);
  },
  fail(err) {
    console.error('启用notify失败', err);
  }
});

本题详细解读

1. 参数说明

• deviceId: 蓝牙设备的唯一标识符，通常通过 wx.getBluetoothDevices 或 wx.createBLEConnection 获取。
• serviceId: 蓝牙服务的UUID，通过 wx.getBLEDeviceServices 获取。
• characteristicId: 蓝牙特征值的UUID，通过 wx.getBLEDeviceCharacteristics 获取。
• state: 布尔值，true 表示启用notify功能，false 表示关闭notify功能。

2. 使用场景

wx.notifyBLECharacteristicValueChange 用于启用或关闭蓝牙设备特征值的notify功能。启用后，当特征值发生变化时，会触发 wx.onBLECharacteristicValueChange 事件，从而可以实时获取特征值的变化。

3. 注意事项

• 在调用 wx.notifyBLECharacteristicValueChange 之前，确保已经成功连接蓝牙设备并获取了服务UUID和特征值UUID。
• 启用notify功能后，需要监听 wx.onBLECharacteristicValueChange 事件来处理特征值的变化。
• 如果特征值不支持notify功能，调用此API会失败。

4. 示例代码

// www.javascriptcn.com code example
wx.startBluetoothDevicesDiscovery({
  success(res) {
    wx.createBLEConnection({
      deviceId: '设备ID',
      success(res) {
        wx.getBLEDeviceServices({
          deviceId: '设备ID',
          success(res) {
            wx.getBLEDeviceCharacteristics({
              deviceId: '设备ID',
              serviceId: '服务UUID',
              success(res) {
                wx.notifyBLECharacteristicValueChange({
                  deviceId: '设备ID',
                  serviceId: '服务UUID',
                  characteristicId: '特征值UUID',
                  state: true,
                  success(res) {
                    console.log('启用notify成功', res);
                  },
                  fail(err) {
                    console.error('启用notify失败', err);
                  }
                });
              }
            });
          }
        });
      }
    });
  }
});

5. 错误处理

• 如果设备未连接或连接失败，调用 wx.notifyBLECharacteristicValueChange 会失败。
• 如果特征值不支持notify功能，调用此API会失败。
• 如果设备不支持蓝牙或蓝牙未打开，调用此API会失败。