使用Radius Networks Android蓝牙Beacon库无法检测附近AltBeacon设备

我之前在使用AltBeacon库时也碰到过类似的检测失效问题，给你列几个按优先级排序的排查点，一步步来应该能定位原因：

1. 先确认基础权限是否齐全 #

Android 12及以上版本对蓝牙权限有严格的分区，少一个都可能导致扫描完全失效：

• 首先在AndroidManifest.xml里添加必要权限：

<!-- 蓝牙扫描与连接权限（Android 12+） -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 位置权限（Android 11及以下需要，用于蓝牙扫描） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<!-- 确保蓝牙硬件可用 -->
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

• 还要在代码中动态申请这些权限，尤其是BLUETOOTH_SCAN和BLUETOOTH_CONNECT，没有用户授权的话，系统会直接拦截扫描请求。

2. 用官方工具验证Beacon本身的可用性 #

先别纠结自己的代码，用AltBeacon官方的Locate应用（Google Play可下载）扫描你的Radius Beacon：

• 如果官方app也检测不到：那问题出在Beacon配置上——确认你确实把Beacon改成了AltBeacon格式广播，调整速率后有没有重启Beacon？或者试试把Beacon的发射功率调高一点，避免信号太弱。
• 如果官方app能检测到：那问题肯定在你的代码逻辑里，继续往下排查。

3. 检查Beacon解析器与Region配置 #

• 虽然库默认支持AltBeacon，但有时候会因为自定义解析器覆盖了默认规则，或者Region过滤条件太严导致漏检：
  • 手动添加标准AltBeacon解析器，确保格式匹配：

  beaconManager.getBeaconParsers().add(new BeaconParser()
          .setBeaconLayout(BeaconParser.ALTBEACON_LAYOUT));
  

  • 检查Region的设置：如果你指定了具体的UUID/Major/Minor，要确保和Beacon的配置完全一致；如果想扫描所有AltBeacon，用null作为匹配条件：

  Region allBeaconsRegion = new Region("all-beacons", null, null, null);
  beaconManager.startRangingBeaconsInRegion(allBeaconsRegion);
  

4. 排除系统省电限制 #

很多Android厂商的省电模式会后台限制蓝牙扫描，尤其是应用处于后台时：

• 进入设备的电池优化设置，把你的应用设为“不优化”；
• 暂时关闭系统全局的省电模式，再测试扫描效果。

5. 确认代码扫描逻辑的正确性 #

• 确保你在onBeaconServiceConnect()回调里启动扫描——因为Beacon服务需要先绑定成功才能工作：

@Override
public void onBeaconServiceConnect() {
    beaconManager.addRangeNotifier((beacons, region) -> {
        // 这里处理扫描到的Beacon数据
        if (!beacons.isEmpty()) {
            Log.d("BeaconScan", "检测到Beacon: " + beacons.get(0).getId1());
        }
    });
    try {
        beaconManager.startRangingBeaconsInRegion(allBeaconsRegion);
    } catch (RemoteException e) {
        e.printStackTrace();
    }
}

• 另外，不要在Activity的onCreate里直接启动扫描，必须等服务绑定完成后再执行。

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