Altbeacon测距在手机蓝牙关闭重开后无法检测信标的问题

Android 11及以上版本调整了蓝牙栈状态管控逻辑：手机蓝牙关闭再重新开启时，系统会强制重置所有正在进行的蓝牙扫描会话。Altbeacon库默认不会自动感知蓝牙状态变化、主动重启扫描任务，加上当前配置将前后台两次扫描的间隔时间设为0，会在蓝牙重置后触发扫描线程卡死，最终导致蓝牙恢复后无法正常检测信标，该问题在区域监测、测距模式下均可复现。

1. 监听蓝牙状态变化主动重启扫描 #

注册系统广播监听蓝牙开关状态，当蓝牙从关闭状态恢复为开启状态时，主动重置扫描流程，不要依赖库的自动恢复逻辑。
核心实现代码：

// 将使用的Region定义为全局变量，方便重启扫描时调用
val eddystoneRegion = Region("eddystoneRegionName", Identifier.parse("0xD0F5A71096E300000000"), null, null)

private val bluetoothStateReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (BluetoothAdapter.ACTION_STATE_CHANGED == intent.action) {
            val state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)
            when (state) {
                BluetoothAdapter.STATE_ON -> {
                    // 清除现有残留的异常扫描任务
                    iBeaconManager.stopRangingBeacons(eddystoneRegion)
                    // 检查BeaconManager服务绑定状态，未绑定则重新绑定
                    if (!iBeaconManager.isBound(context)) {
                        iBeaconManager.bind(context, beaconServiceConnection)
                    }
                    // 延迟1秒启动扫描，等待系统蓝牙栈完全初始化
                    Handler(Looper.getMainLooper()).postDelayed({
                        iBeaconManager.startRangingBeacons(eddystoneRegion)
                    }, 1000)
                }
                BluetoothAdapter.STATE_OFF -> {
                    // 蓝牙关闭时主动停止扫描，避免状态残留
                    iBeaconManager.stopRangingBeacons(eddystoneRegion)
                }
            }
        }
    }
}

需要在页面/服务的生命周期中注册和注销该广播，Android 12及以上版本需要申请BLUETOOTH_CONNECT运行时权限才能正常接收蓝牙状态广播。

2. 修正不合理的扫描配置 #

将前后台扫描间隔周期设为0会让扫描线程无间隔运行，在Moto等接近原生实现的ROM上容易触发扫描循环死锁，蓝牙状态重置后无法自动拉起新的扫描任务，调整为合理值即可：

// 两次扫描之间留100ms间隔，避免扫描线程卡死
iBeaconManager.backgroundBetweenScanPeriod = 100
iBeaconManager.foregroundBetweenScanPeriod = 100
iBeaconManager.backgroundScanPeriod = 500
iBeaconManager.foregroundScanPeriod = 500

补充说明 #

配置的Eddystone TLM帧解析器不需要单独绑定扫描区域，只要对应UID的信标在扫描范围内，库会自动解析同一设备发出的TLM遥测数据，无需额外配置。

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