Eddystone Beacon未检测到，求实现检测触发Activity启动方案（急）

别急，只剩两天时间咱们一步步来定位问题，Eddystone检测没反应的坑大多集中在权限、库配置、设备设置这几个核心环节，按下面的步骤排查应该能快速找到根因：

一、先把权限配置拉满（最容易踩的坑） #

Android不同版本对BLE扫描的权限要求差异很大，务必确认Manifest和动态权限都到位：

• Manifest声明：在AndroidManifest.xml里添加以下权限（根据你的目标SDK调整）：

  <!-- 基础BLE权限 -->
  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <!-- Android 12+ 专属权限 -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  <!-- 位置权限（Android 6.0+ 必需，部分设备即使不需要定位也得开） -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!-- 后台扫描需要（如果你的App在后台也要检测） -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  

• 动态权限申请：在启动扫描前，必须动态请求BLUETOOTH_SCAN、ACCESS_FINE_LOCATION（如果是Android 12+），别依赖Manifest声明就完事了。

二、验证AltBeacon库的配置是否正确 #

确保你针对Eddystone的解析器和初始化逻辑没写错：

• 依赖确认：检查build.gradle里的库依赖是否是最新稳定版：

  implementation 'org.altbeacon:android-beacon-library:2.21.4'
  

• 添加Eddystone解析器：初始化BeaconManager时，必须添加对应类型的Eddystone解析布局，比如你用的是Eddystone-UID，要加这个：

  BeaconManager beaconManager = BeaconManager.getInstanceForApplication(this);
  // 添加Eddystone-UID解析器
  beaconManager.getBeaconParsers().add(new BeaconParser()
          .setBeaconLayout("s:0-1=feaa,m:2-2=00,p:3-3:-41,i:4-13,i:14-19"));
  // 如果是Eddystone-URL，还要加这个布局
  // beaconManager.getBeaconParsers().add(new BeaconParser()
  //         .setBeaconLayout("s:0-1=feaa,m:2-2=10,p:3-3:-41,i:4-20v"));
  

• 确认扫描回调注册：在onBeaconServiceConnect()里注册监听器，哪怕先打印日志确认回调触发：

  beaconManager.bind(new BeaconConsumer() {
      @Override
      public void onBeaconServiceConnect() {
          // 先打印日志确认服务连接成功
          Log.d("BeaconDebug", "Beacon服务已连接，准备启动扫描");
          
          // 注册Monitor监听器检测Beacon出现
          beaconManager.addMonitorNotifier(new MonitorNotifier() {
              @Override
              public void didEnterRegion(Region region) {
                  Log.d("BeaconDebug", "检测到Eddystone Beacon！");
                  // 这里跳转你的指定Activity
                  startActivity(new Intent(MainActivity.this, TargetActivity.class));
              }
  
              @Override
              public void didExitRegion(Region region) {}
  
              @Override
              public void didDetermineStateForRegion(int i, Region region) {}
          });
  
          // 启动扫描
          try {
              beaconManager.startMonitoringBeaconsInRegion(new Region("myEddystoneRegion", null, null, null));
              Log.d("BeaconDebug", "扫描已启动");
          } catch (RemoteException e) {
              Log.e("BeaconDebug", "启动扫描失败", e);
          }
      }
  });
  

三、确认扫描是否真的在运行 #

如果没有任何日志，先打开库的Debug模式看底层日志：

• 开启Debug日志：在Application类或者Activity初始化时添加：

  BeaconManager.setDebug(true);
  

  然后在Logcat里过滤AltBeacon或者BeaconService标签，你会看到库的详细日志，比如：
  • 如果看到Starting scanning for beacons，说明扫描已启动；
  • 如果看到Permissions not granted, can't scan，说明权限没申请到位；
  • 如果看到Bluetooth is disabled，说明蓝牙没开。

四、设备端设置排查 #

很多时候不是代码的问题，是设备系统限制：

• 蓝牙必须开启：确保设备蓝牙处于打开状态，可以在代码里检测蓝牙状态，没开的话引导用户打开；
• 位置服务必须开启：绝大多数Android设备要求开启位置服务才能扫描BLE设备，哪怕你不需要定位信息；
• 关闭电池优化：把你的App加入电池优化白名单，否则系统会在后台杀死扫描服务，尤其是国产ROM（小米、华为、OPPO等）的后台限制很严；
• 测试设备兼容性：有些旧设备对BLE的支持不好，换个设备试试，排除硬件问题。

五、确认Beacon本身在广播信号 #

别排除Beacon的问题，用第三方工具验证：

• 用BLE扫描工具（比如nRF Connect），看看能不能搜到你的Eddystone Beacon，确认它在广播，并且广播的是正确的Eddystone帧（UID/URL）。

按照这个流程走，基本能在一天内定位到问题，剩下一天修复就行，祝你顺利！

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