如何使用 wx.createBLEConnection 建立与低功耗蓝牙设备的连接？

推荐答案

// www.javascriptcn.com code example
wx.createBLEConnection({
  deviceId: '设备ID', // 必填，蓝牙设备的 deviceId
  success(res) {
    console.log('连接成功', res);
  },
  fail(err) {
    console.error('连接失败', err);
  },
  complete() {
    console.log('连接操作完成');
  }
});

本题详细解读

1. wx.createBLEConnection 的作用

wx.createBLEConnection 是微信小程序提供的 API，用于与低功耗蓝牙设备（BLE）建立连接。连接成功后，可以进一步进行数据通信。

2. 参数说明

• deviceId：必填参数，表示要连接的蓝牙设备的 ID。这个 ID 可以通过 wx.startBluetoothDevicesDiscovery 和 wx.onBluetoothDeviceFound 获取。
• success：连接成功时的回调函数，返回连接结果。
• fail：连接失败时的回调函数，返回错误信息。
• complete：连接操作完成时的回调函数，无论成功或失败都会执行。

3. 使用步骤

1. 发现设备：首先需要通过 wx.startBluetoothDevicesDiscovery 开始搜索蓝牙设备，并通过 wx.onBluetoothDeviceFound 监听发现的设备。
2. 获取设备 ID：在发现设备后，获取目标设备的 deviceId。
3. 建立连接：使用 wx.createBLEConnection 并传入 deviceId 来建立连接。
4. 处理连接结果：在 success 回调中处理连接成功后的逻辑，在 fail 回调中处理连接失败的情况。

4. 注意事项

• 在连接设备之前，确保已经获取了设备的 deviceId。
• 连接成功后，可以通过 wx.getBLEDeviceServices 获取设备的服务列表，进一步进行数据通信。
• 连接失败时，可以根据错误信息进行重试或提示用户。

5. 示例代码

// www.javascriptcn.com code example
wx.startBluetoothDevicesDiscovery({
  success(res) {
    wx.onBluetoothDeviceFound((res) => {
      const deviceId = res.devices[0].deviceId;
      wx.createBLEConnection({
        deviceId,
        success(res) {
          console.log('连接成功', res);
        },
        fail(err) {
          console.error('连接失败', err);
        }
      });
    });
  }
});

通过以上步骤，你可以成功建立与低功耗蓝牙设备的连接，并进一步进行数据通信。