Qt Android蓝牙开发中常见的技术问题之一是： **如何在Qt for Android中实现蓝牙设备的搜索与配对？** 这个问题涵盖了Qt Android蓝牙开发中的核心难点：跨平台蓝牙功能的实现、Android权限配置、设备扫描与连接流程等关键步骤。

Question

在Qt for Android蓝牙开发中，一个常见的关键技术问题是：**如何在不同Android版本下正确实现蓝牙设备的搜索与配对？** 该问题涉及蓝牙权限动态申请、蓝牙适配器初始化、设备扫描启动与停止、设备列表更新以及配对流程处理。由于Android系统对蓝牙功能的限制日益严格，特别是在Android 6.0以上需动态申请位置权限、Android 12引入新的蓝牙权限机制，开发者常面临扫描不到设备、无法完成配对或程序崩溃等问题。此外，Qt与原生Android蓝牙API的交互逻辑复杂，也增加了实现难度。

Answer 1

一、蓝牙权限动态申请机制的演进与适配策略

随着Android系统版本的迭代，蓝牙功能所需的权限也不断变化。从Android 6.0（Marshmallow）开始引入了运行时权限机制，开发者需要在应用运行过程中主动请求位置权限，以支持设备扫描；而在Android 12（Sv2）中，Google进一步细化了蓝牙相关权限，引入了BLUETOOTH_SCAN、BLUETOOTH_CONNECT等新权限。

• Android 6.0~11： 需要申请ACCESS_FINE_LOCATION权限用于扫描蓝牙设备。
• Android 12及以上： 引入新的蓝牙权限组，需根据操作类型分别申请：
  • BLUETOOTH_SCAN：用于扫描设备
  • BLUETOOTH_CONNECT：用于连接设备
  • BLUETOOTH_ADVERTISE：用于广播自身为BLE设备

Android版本	所需权限	用途说明
6.0 ~ 11	ACCESS_FINE_LOCATION	启用蓝牙扫描和发现功能
12及以上	BLUETOOTH_SCAN, BLUETOOTH_CONNECT	区分扫描与连接行为，增强隐私保护

二、Qt for Android蓝牙模块的核心类与初始化流程

Qt提供了跨平台蓝牙开发模块QtBluetooth，但在Android平台上其底层依赖于原生蓝牙API，因此在某些情况下仍需通过JNI调用原生代码来实现高级控制。

核心类包括：

• QBluetoothDeviceDiscoveryAgent：用于启动设备扫描
• QBluetoothLocalDevice：管理本地蓝牙适配器状态
• QBluetoothSocket：用于建立SPP或BLE连接

QBluetoothDeviceDiscoveryAgent *discoveryAgent = new QBluetoothDeviceDiscoveryAgent(this);
connect(discoveryAgent, &QBluetoothDeviceDiscoveryAgent::deviceDiscovered,
        this, &MyBluetoothManager::addDevice);
discoveryAgent->start();

在Android上初始化蓝牙模块前，必须确保蓝牙已启用且权限已授予。否则会出现Permission Denial异常。

三、设备扫描与列表更新的实现逻辑

设备扫描是蓝牙开发中的基础环节。在Qt中可通过QBluetoothDeviceDiscoveryAgent启动扫描，并监听设备发现信号进行列表更新。

1. 检查当前蓝牙是否启用
2. 申请必要权限（根据系统版本）
3. 创建并启动扫描代理
4. 监听设备发现事件并更新UI
5. 停止扫描后释放资源

由于Android 12限制后台扫描，建议在前台服务中执行长时间扫描操作。

四、不同Android版本下的配对流程差异处理

蓝牙设备配对涉及用户交互与系统安全机制，尤其在高版本Android中更为严格。

graph TD A[请求配对] -- Android 6-11 --> B{是否有BLUETOOTH_PRIVILEGED权限?} B -- 是 --> C[自动配对] B -- 否 --> D[弹出系统配对对话框] A -- Android 12+ --> E[使用BluetoothLeScanner API] E --> F[请求BLUETOOTH_CONNECT权限] F --> G{用户确认授权?} G -- 是 --> H[完成配对] G -- 否 --> I[配对失败]

在Qt中，通常通过QBluetoothDeviceInfo::pairingStatus()判断配对状态，但部分操作仍需借助Java层API完成。

五、Qt与Android原生蓝牙API的交互机制

由于Qt的蓝牙模块在Android上基于原生API封装，开发者有时需要通过JNI访问原生接口实现更精细控制。

• 获取JNIEnv和jobject上下文
• 调用Java层方法，如BluetoothLeScanner.startScan()
• 注册自定义BroadcastReceiver监听蓝牙状态变化

// Java层示例：注册蓝牙状态监听
IntentFilter filter = new IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED);
registerReceiver(mReceiver, filter);

在Qt中可以通过QtAndroid::registerReceiver()注册接收器，并结合C++信号槽机制进行状态同步。