React Native中react-native-ble-plx与@hkpuits信标管理包冲突排查

问题描述 #

原本使用@hkpuits/react-native-beacons-manager可正常检测TI蓝牙信标，安装react-native-ble-plx以支持nRF信标后，前者完全无法检测TI信标（未修改原有代码），后者可正常识别nRF信标。需要两个包共存以同时支持两类信标。

环境信息 #

• @hkpuits/react-native-beacons-manager: ^1.3.4
• react: 18.3.1
• react-native: 0.75.4
• react-native-ble-plx: ^3.2.1

已尝试操作 #

• 移除react-native-ble-plx后，@hkpuits/react-native-beacons-manager恢复正常检测TI信标
• 重新安装并重新关联两个依赖包
• 检查AndroidManifest.xml中的蓝牙权限与配置，未发现冲突

解决方案建议 #

1. 错开扫描时机，避免资源抢占 #

两个库可能同时抢占蓝牙扫描资源，导致其中一个无法获取扫描结果。可以通过状态管理手动控制扫描启停：

• 先启动react-native-ble-plx完成nRF信标扫描，再启动@hkpuits/react-native-beacons-manager扫描TI信标
• 或者设置定时切换扫描，比如每30秒交替启动两个库的扫描任务

2. 调整react-native-ble-plx的扫描参数 #

检查react-native-ble-plx的扫描配置，是否开启了独占模式。尝试修改扫描模式：

// 示例：修改react-native-ble-plx扫描模式
manager.startDeviceScan(
  null,
  { scanMode: ScanMode.BALANCED }, // 替换为LOW_POWER或BALANCED，避免高优先级抢占
  (error, device) => { /* 扫描逻辑 */ }
);

3. 排查Native层蓝牙实例冲突 #

两个库在原生层可能对蓝牙管理器的初始化方式冲突：

• Android端：检查BeaconManager.java和BleManager.java中是否重复初始化了BluetoothAdapter，尝试修改其中一个库的代码，使用共享的蓝牙实例
• iOS端：查看RCTBeaconsManager.m和RNBleManager.m中的蓝牙管理器配置，确保两者的扫描回调不互相覆盖

4. 基于react-native-ble-plx统一扫描逻辑 #

如果共存问题无法解决，可以直接用react-native-ble-plx实现TI信标的扫描，无需依赖另一个库：

import { BleManager } from 'react-native-ble-plx';

const bleManager = new BleManager();

// 扫描所有蓝牙设备，过滤TI信标
bleManager.startDeviceScan(null, null, (error, device) => {
  if (error) {
    console.error('扫描错误:', error);
    return;
  }

  // 根据TI信标的UUID、设备名或广播数据过滤
  const tiBeaconUUID = '你的TI信标UUID';
  if (device.serviceUUIDs?.includes(tiBeaconUUID) || device.name?.includes('TI-Beacon')) {
    console.log('检测到TI信标:', device);
    // 可解析广播数据获取Major/Minor等信息
  }
});

内容的提问来源于stack exchange，提问作者Deepak Verma