uniapp如何实现蓝牙配对功能

在uniapp中如何实现蓝牙设备的配对功能？我尝试使用uni.getBluetoothDevices和uni.createBLEConnection接口，但始终无法成功连接设备。具体需求是：1)扫描周围蓝牙设备；2)选择目标设备进行配对；3)建立稳定连接后传输数据。请问正确的API调用流程是什么？是否需要特殊权限配置？Android和iOS平台的处理方式是否有差异？遇到错误码10000该如何解决？求完整的示例代码和常见问题解决方案。

h691938207 1楼

在uni-app中，使用uni.createBLEConnection连接设备，通过uni.onBLECharacteristicValueChange监听数据。配对过程需先扫描设备（uni.startBluetoothDevicesDiscovery），获取设备ID后连接，并处理配对请求。注意不同平台权限配置。

yibo5220 2楼

在 UniApp 中实现蓝牙配对功能，主要依赖 uni 对象提供的蓝牙 API。以下是实现步骤及示例代码：

1. 初始化蓝牙适配器

首先检查并打开蓝牙适配器：

uni.openBluetoothAdapter({
  success: (res) => {
    console.log('蓝牙适配器初始化成功');
    this.startBluetoothDevicesDiscovery(); // 开始搜索设备
  },
  fail: (err) => {
    console.error('初始化失败:', err);
    uni.showToast({ title: '请开启手机蓝牙', icon: 'none' });
  }
});

2. 搜索蓝牙设备

开始搜索附近的蓝牙设备：

startBluetoothDevicesDiscovery() {
  uni.startBluetoothDevicesDiscovery({
    services: [], // 可指定服务UUID，空数组搜索所有设备
    success: (res) => {
      console.log('开始搜索设备');
      this.onBluetoothDeviceFound(); // 监听发现设备
    },
    fail: (err) => {
      console.error('搜索失败:', err);
    }
  });
}

3. 监听发现设备

获取搜索到的设备列表：

onBluetoothDeviceFound() {
  uni.onBluetoothDeviceFound((devices) => {
    devices.devices.forEach(device => {
      if (device.name && !this.deviceList.some(d => d.deviceId === device.deviceId)) {
        this.deviceList.push(device); // 将设备加入列表
      }
    });
  });
}

4. 连接设备

选择设备后建立连接：

connectDevice(deviceId) {
  uni.createBLEConnection({
    deviceId,
    success: (res) => {
      console.log('连接成功');
      uni.showToast({ title: '配对成功' });
      this.getBLEDeviceServices(deviceId); // 获取设备服务
    },
    fail: (err) => {
      console.error('连接失败:', err);
    }
  });
}

5. 获取服务及特征值（配对关键）

连接后需发现服务并监听特征值变化：

getBLEDeviceServices(deviceId) {
  uni.getBLEDeviceServices({
    deviceId,
    success: (res) => {
      res.services.forEach(serviceId => {
        this.getBLEDeviceCharacteristics(deviceId, serviceId);
      });
    }
  });
}

getBLEDeviceCharacteristics(deviceId, serviceId) {
  uni.getBLEDeviceCharacteristics({
    deviceId,
    serviceId,
    success: (res) => {
      // 监听特征值变化（根据设备协议操作）
      res.characteristics.forEach(char => {
        if (char.properties.notify) {
          uni.notifyBLECharacteristicValueChange({
            deviceId,
            serviceId,
            characteristicId: char.characteristicId,
            state: true
          });
        }
      });
    }
  });
}

注意事项：

权限配置：在 manifest.json 中申请蓝牙权限（App 平台需配置，H5 不支持）。
设备过滤：可通过 services 参数过滤指定 UUID 的设备。
配对机制：蓝牙配对实际由系统底层处理，应用层主要通过连接/通信完成绑定。
兼容性：不同设备特征值可能不同，需根据硬件文档调整代码。