使用Beacons-Android库实现Eddystone信标无法被扫描识别求助

我来帮你梳理下这个问题的排查方向，先看看你的实现代码和运行日志：

你的实现代码 #

public class MainActivity extends AppCompatActivity {
 EddystoneURL beacon = new EddystoneURL("www.github.com");
 @Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
 Beacons.initialize(this);
 beacon.init(5, AdvertiseSettings.ADVERTISE_MODE_LOW_LATENCY,AdvertiseSettings.ADVERTISE_TX_POWER_HIGH,0,"Eddie");
 beacon.start();
 UUID uuid = beacon.getUUID();
 String name = beacon.getName();
 Log.i("Log","name is "+name);
 Log.i("Log",uuid.toString());
 String url = beacon.getURL();
 Log.i("Log",url);
 Log.i("Log","App started");
 int k = beacon.getActiveState();
 Log.i("Log","active state : "+k);
 int powerlvl = beacon.getTxPowerLevel();
 Log.i("Log","Power Lvl : "+ powerlvl);
 }
}

运行日志 #

2020-04-09 20:27:42.771 14922-14922/? I/Log: name is Eddie
2020-04-09 20:27:42.772 14922-14922/? I/Log: 21ac707d-2ef0-4578-aa52-f8b8020d97c3
2020-04-09 20:27:42.772 14922-14922/? I/Log: www.github.com
2020-04-09 20:27:42.772 14922-14922/? I/Log: App started
2020-04-09 20:27:42.772 14922-14922/? I/Log: active state : 0
2020-04-09 20:27:42.772 14922-14922/? I/Log: Power Lvl : 3

接下来咱们从几个核心方向排查问题：

1. 修复Eddystone URL的格式问题 #

Eddystone URL标准要求必须包含协议前缀（比如https://或http://），你现在传入的www.github.com缺少这个前缀，很多扫描器会直接忽略不符合标准的URL帧。修改代码如下：

EddystoneURL beacon = new EddystoneURL("https://www.github.com");

2. 补全必要的蓝牙权限 #

Android系统对蓝牙广播的权限要求很严格，尤其是高版本系统：

• 在AndroidManifest.xml里添加这些权限：

<!-- 适配旧版本蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<!-- Android 12+ 专属广播/扫描权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<!-- 位置权限（BLE扫描必须） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 声明设备支持BLE -->
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

• 还要在代码里动态请求位置权限（API 23及以上），确保权限授予后再启动信标，不然广播会被系统拦截。

3. 调整信标初始化参数 #

你调用beacon.init()时的第四个参数是0，这个应该是广播间隔（单位通常是毫秒）。设置为0不符合系统的广播间隔限制，建议改成合理值，比如1000（1秒）：

beacon.init(5, AdvertiseSettings.ADVERTISE_MODE_LOW_LATENCY,AdvertiseSettings.ADVERTISE_TX_POWER_HIGH,1000,"Eddie");

4. 检查蓝牙状态与设备兼容性 #

• 确保你的设备蓝牙已经开启，并且支持BLE（蓝牙低功耗）功能；
• 可以在代码里加个蓝牙状态检查，避免蓝牙未开启就启动广播：

BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter();
if (bluetoothAdapter == null || !bluetoothAdapter.isEnabled()) {
    Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
    startActivityForResult(enableBtIntent, 1);
}

5. 验证信标启动状态 #

日志里的active state : 0需要重点关注，你可以去查一下这个库的文档或者源码，确认这个状态码对应的含义——如果0代表广播未启动或者启动失败，那就要针对性排查启动失败的原因，比如权限不足、蓝牙未开启等。

6. 换用标准扫描工具测试 #

有些第三方扫描器可能对Eddystone的支持不够完善，建议用Google的Nearby应用或者专门的Eddystone扫描工具测试，排除扫描器本身的问题。

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