如何使用 wx.writeBLECharacteristicValue 向蓝牙设备特征值写入二进制数据？

推荐答案

// www.javascriptcn.com code example
wx.writeBLECharacteristicValue({
  deviceId: '设备ID', // 蓝牙设备ID
  serviceId: '服务UUID', // 蓝牙服务UUID
  characteristicId: '特征值UUID', // 蓝牙特征值UUID
  value: arrayBuffer, // 要写入的二进制数据，类型为ArrayBuffer
  success(res) {
    console.log('写入成功', res);
  },
  fail(err) {
    console.error('写入失败', err);
  }
});

本题详细解读

1. 参数说明

• deviceId: 蓝牙设备的唯一标识符，通常通过 wx.getBluetoothDevices 或 wx.onBluetoothDeviceFound 获取。
• serviceId: 蓝牙服务的UUID，通常通过 wx.getBLEDeviceServices 获取。
• characteristicId: 蓝牙特征值的UUID，通常通过 wx.getBLEDeviceCharacteristics 获取。
• value: 要写入的二进制数据，必须是一个 ArrayBuffer 对象。

2. 使用步骤

1. 获取设备ID: 通过 wx.getBluetoothDevices 或 wx.onBluetoothDeviceFound 获取蓝牙设备的 deviceId。
2. 获取服务UUID: 通过 wx.getBLEDeviceServices 获取蓝牙设备的服务列表，并选择目标服务的 serviceId。
3. 获取特征值UUID: 通过 wx.getBLEDeviceCharacteristics 获取服务的特征值列表，并选择目标特征值的 characteristicId。
4. 准备数据: 将要写入的数据转换为 ArrayBuffer 格式。
5. 调用API: 使用 wx.writeBLECharacteristicValue 将数据写入蓝牙设备的特征值。

3. 注意事项

• 权限: 确保小程序已获取蓝牙相关权限。
• 连接状态: 在写入数据之前，确保蓝牙设备已连接。
• 数据格式: 写入的数据必须是 ArrayBuffer 格式，否则会报错。
• 错误处理: 建议在 fail 回调中处理可能的错误，如设备未连接、特征值不可写等。

4. 示例代码

// www.javascriptcn.com code example
// 假设已经获取了 deviceId, serviceId, characteristicId
const arrayBuffer = new ArrayBuffer(4); // 创建一个4字节的ArrayBuffer
const dataView = new DataView(arrayBuffer);
dataView.setUint8(0, 0x01); // 写入数据
dataView.setUint8(1, 0x02);
dataView.setUint8(2, 0x03);
dataView.setUint8(3, 0x04);

wx.writeBLECharacteristicValue({
  deviceId: 'deviceId',
  serviceId: 'serviceId',
  characteristicId: 'characteristicId',
  value: arrayBuffer,
  success(res) {
    console.log('写入成功', res);
  },
  fail(err) {
    console.error('写入失败', err);
  }
});