Android Kotlin开发中BLE设备配对状态检测失败问题咨询

问题根因 #

你当前的判断逻辑始终返回false，通常是以下几个原因导致：

• 未申请对应蓝牙权限：Android 12（API 31）及以上系统要求必须持有BLUETOOTH_CONNECT权限才能读取BluetoothDevice的bondState属性，未授权时系统会默认返回BOND_NONE，匹配不到BOND_BONDED的状态值。
• 使用了缓存的BluetoothDevice实例：扫描得到或者提前缓存的设备实例状态不会自动同步更新，配对状态变化后需要重新拉取最新的设备实例读取状态。
• 状态判断时机错误：点击条目时立刻判断的是点击瞬间的配对状态，用户完成配对弹窗操作后的状态需要通过广播异步接收，不能在点击的同步逻辑里直接判断。

优化实现方案 #

1. 先完成蓝牙权限校验 #

在读取配对状态前先校验权限，Android 12以上申请BLUETOOTH_CONNECT，更低版本申请BLUETOOTH权限：

// 权限校验示例，可放在点击事件最前面
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
        // 申请BLUETOOTH_CONNECT权限，回调后再执行后续逻辑
        ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.BLUETOOTH_CONNECT), REQUEST_BLUETOOTH_CONNECT)
        return@setOnClickListener
    }
} else {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.BLUETOOTH), REQUEST_BLUETOOTH)
        return@setOnClickListener
    }
}

2. 修正配对状态判断逻辑 #

不要使用缓存的BluetoothDevice实例，每次判断时通过设备MAC地址重新拉取最新实例：

// 传入目标设备的MAC地址，获取最新的BluetoothDevice实例
val latestDevice = BluetoothAdapter.getDefaultAdapter().getRemoteDevice(targetMac)
// 读取最新配对状态
@Suppress("MissingPermission")
val isBonded = latestDevice.bondState == BluetoothDevice.BOND_BONDED

if (isBonded) {
    // 已配对，直接跳转到目标页面
    navigateToTargetPage()
} else if (latestDevice.bondState == BluetoothDevice.BOND_NONE) {
    // 未配对，触发配对请求
    latestDevice.createBond()
    Toast.makeText(this, "请完成设备配对", Toast.LENGTH_SHORT).show()
} else {
    // 正在配对中，避免重复触发
    Toast.makeText(this, "正在配对中，请稍后", Toast.LENGTH_SHORT).show()
}

3. 正确实现配对状态广播监听 #

注册广播接收器监听配对状态变化，收到配对成功的回调后再执行跳转逻辑：

// 初始化广播接收器
private val bondStateReceiver = object : BroadcastReceiver() {
    @Suppress("MissingPermission")
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == BluetoothDevice.ACTION_BOND_STATE_CHANGED) {
            val device = intent.getParcelableExtra<BluetoothDevice>(BluetoothDevice.EXTRA_DEVICE) ?: return
            val bondState = intent.getIntExtra(BluetoothDevice.EXTRA_BOND_STATE, BluetoothDevice.ERROR)
            // 只处理当前点击的目标设备的状态变化
            if (device.address == targetMac && bondState == BluetoothDevice.BOND_BONDED) {
                // 配对成功，跳转页面
                navigateToTargetPage()
                Toast.makeText(context, "配对成功", Toast.LENGTH_SHORT).show()
            } else if (bondState == BluetoothDevice.BOND_NONE) {
                Toast.makeText(context, "配对失败，请重试", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

// 注册广播，可放在onCreate或者点击设备之后
override fun onStart() {
    super.onStart()
    val filter = IntentFilter(BluetoothDevice.ACTION_BOND_STATE_CHANGED)
    registerReceiver(bondStateReceiver, filter)
}

// 页面销毁时注销广播，避免内存泄漏
override fun onStop() {
    super.onStop()
    unregisterReceiver(bondStateReceiver)
}

注意事项 #

• 不要在点击事件的同步逻辑里等待配对结果，配对是异步操作，必须通过广播回调处理结果。
• 如果是系统弹窗的配对请求，不需要自己实现输入PIN码的逻辑，系统会自动处理。
• 如果配对的是BLE设备，配对成功后建议先连接GATT服务再跳转，避免出现配对成功但连接异常的问题。

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