React Native中如何使用react-native-ble-plx连接配对LE蓝牙设备

1. 权限配置校验 #

• 安卓端（Android 12及以上）必须配置以下权限：

  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
  

  低于Android 12的版本需要单独申请位置权限，且必须确保用户已完成授权。
• iOS端需要在Info.plist中添加NSBluetoothAlwaysUsageDescription、NSBluetoothPeripheralUsageDescription权限描述，需要后台连接时还要额外开启蓝牙后台模式。

2. 扫描阶段逻辑检查 #

• 扫描时不要添加错误的服务UUID过滤规则，若不确定目标设备广播的服务UUID，先去掉过滤参数扫描全量设备，确认目标设备可以被正常扫描到、拿到正确的device.id后再发起连接请求。
• 不要在扫描运行过程中发起连接，连接前必须先调用stopScan()停止扫描，否则大概率会出现连接超时错误。

3. 连接参数配置检查 #

• 不要设置过短的连接超时阈值，建议超时时间设置在10s以上，标准连接调用示例如下：

  device.connect({
    autoConnect: false,
    timeout: 10000
  })
  .then(device => device.discoverAllServicesAndCharacteristics())
  .then(device => {
    // 连接成功后续业务逻辑
  })
  .catch(error => {
    console.log('连接错误详情：', error.message)
  })
  

• 若目标设备需要配对才能连接，要提前处理配对逻辑，未完成配对直接发起连接会被系统直接拒绝。
• 注意：autoConnect参数设置为true时，连接触发时间由系统蓝牙调度决定，可能出现数分钟的延迟，主动连接场景建议设置为false。

4. 设备端限制排查 #

• 确认目标LE设备没有处于已连接状态，大部分BLE设备同一时间仅支持单连接，已和其他设备绑定的情况下无法被新设备连接。
• 确认设备没有进入休眠/低功耗模式，低功耗模式下设备会关闭广播和连接通道，无法响应连接请求。

5. 常见错误处理 #

• 如果报错Device is not connected，说明设备在连接过程中被系统断连，可尝试关闭系统蓝牙重新开启后重试。
• 如果报错Connection timeout，可移动手机到离BLE设备更近的位置，排除信号干扰、信号强度不足导致的连接失败。

内容的提问来源于stack exchange，提问作者Agraj Vaishnav