如何在React Native中实现BLE设备PIN配对连接？

已尝试的 react-native-ble-manager 适配优化 #

Android 端处理 #

Android的BLE PIN配对由系统弹窗触发，无需库额外实现配对逻辑，但必须确保权限配置到位：

• 在 AndroidManifest.xml 中添加必要权限：

  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!-- Android 12+ 新增权限 -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  

• 调用 connect 方法连接设备时，系统会自动弹出PIN输入弹窗，配对完成后库会触发连接成功回调。若需监听配对状态，可通过原生扩展监听系统广播 ACTION_BOND_STATE_CHANGED，再通过桥接层传递到RN端。

iOS 端处理 #

iOS的BLE配对（含PIN验证）由系统自动处理弹窗：

• 在 Info.plist 中添加蓝牙权限描述：

  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>需要使用蓝牙连接设备</string>
  <key>NSBluetoothPeripheralUsageDescription</key>
  <string>需要使用蓝牙连接外设</string>
  

• 调用 connect 后，系统会弹出验证框（输入PIN或确认配对码），配对成功后触发连接回调。如果设备要求自定义PIN输入（非系统弹窗），需根据设备BLE协议文档，找到配对请求对应的特征UUID，通过 writeCharacteristic 方法写入PIN码完成配对。

其他可用BLE库推荐 #

react-native-ble-plx #

主流BLE库，对配对流程支持更细致：

• Android端可通过 Device 对象的 bond 方法主动触发配对，监听 bondingState 变化获取配对状态。
• iOS端依赖系统配对弹窗，提供完善的连接状态回调，可在 connect 回调中处理配对后逻辑。
• 权限配置逻辑和 react-native-ble-manager 一致，需注意不同系统版本的权限差异。

rn-native-ble #

轻量化库，针对配对场景做了优化：

• 支持监听配对请求事件，部分设备可直接通过API传入PIN码完成配对（需设备协议支持），减少系统弹窗依赖。

通用适配要点 #

• BLE配对核心依赖原生系统蓝牙框架，RN库仅做桥接。若设备需自定义PIN输入，必须获取设备BLE协议文档，定位配对特征UUID后通过写入特征值完成配对。
• 测试前确保设备处于可配对模式（如长按触发配对状态），部分设备需手动激活才能被发现。
• Android不同版本权限差异大，需针对Android 10、12+分别配置对应权限，避免权限不足导致配对失败。
• iOS配对失败后，需进入系统设置蓝牙列表删除设备缓存，再重新尝试配对。

内容的提问来源于stack exchange，提问作者Rohan Yemul