如何使用 wx.onBluetoothDeviceFound 监听寻找到新设备的事件？

推荐答案

wx.onBluetoothDeviceFound(function(res) {
  console.log('发现新设备:', res.devices);
  // 处理发现的设备
});

本题详细解读

1. 监听蓝牙设备发现事件

wx.onBluetoothDeviceFound 是微信小程序提供的 API，用于监听蓝牙设备发现事件。当小程序开始搜索蓝牙设备时，每当发现一个新的蓝牙设备，就会触发这个事件。

2. 回调函数参数

wx.onBluetoothDeviceFound 的回调函数会接收到一个参数 res，其中包含以下信息：

• res.devices: 一个数组，包含所有发现的蓝牙设备信息。每个设备对象包含以下属性：
  • deviceId: 设备的唯一标识符。
  • name: 设备的名称。
  • RSSI: 设备的信号强度。
  • advertisData: 设备的广播数据。
  • advertisServiceUUIDs: 设备的广播服务 UUID 列表。
  • localName: 设备的本地名称。

3. 使用场景

这个 API 通常用于在用户搜索蓝牙设备时，实时更新设备列表，以便用户选择要连接的设备。

4. 注意事项

• 在调用 wx.startBluetoothDevicesDiscovery 开始搜索蓝牙设备之前，必须先调用 wx.openBluetoothAdapter 初始化蓝牙适配器。
• 搜索到的设备信息可能会重复，建议在业务逻辑中去重处理。
• 在不需要监听设备发现事件时，可以调用 wx.offBluetoothDeviceFound 取消监听。

5. 示例代码

// www.javascriptcn.com code example
wx.openBluetoothAdapter({
  success: function(res) {
    wx.startBluetoothDevicesDiscovery({
      success: function(res) {
        wx.onBluetoothDeviceFound(function(res) {
          console.log('发现新设备:', res.devices);
          // 处理发现的设备
        });
      }
    });
  }
});

在这个示例中，首先初始化蓝牙适配器，然后开始搜索蓝牙设备，并通过 wx.onBluetoothDeviceFound 监听新设备的发现事件。