Android 13连接BLE设备时，如何触发设备显示4位PIN码？

问题背景 #

• 第三方应用连接BLE设备时，设备会显示4位PIN码，应用弹出输入框完成配对
• 自研Android 13应用现状：
  • 已实现BLE扫描、connectGatt()连接功能
  • 监听BluetoothDevice.ACTION_BOND_STATE_CHANGED发现绑定状态从BOND_NONE变为BOND_BONDING，未主动调用createBond()
  • 收到BluetoothDevice.ACTION_PAIRING_REQUEST广播，配对类型为PAIRING_VARIANT_CONSENT
• 当前异常：直接手机配对或用自研应用连接时，设备冻结在“Bt pair”界面，无PIN码显示，Android端也无输入请求，自研代码中获取的PAIRING_KEY固定为0

核心问题分析 #

你当前处理的PAIRING_VARIANT_CONSENT配对类型，是系统定义的「无需PIN码、仅需用户确认」的场景，和第三方应用触发的「设备显示PIN、应用输入验证」的PAIRING_VARIANT_PIN场景完全不匹配。此外，BLE设备的PIN显示逻辑可能需要主动触发特定配对流程，而非依赖系统自动的绑定状态变化。

解决方案步骤 #

1. 主动触发PIN型配对流程 #

放弃依赖系统自动触发的BOND_BONDING状态，主动调用createBond()，并在配对请求广播中强制切换到PIN输入模式：

// 连接Gatt后，主动触发配对
mDevice.createBond();

// 在BroadcastReceiver中处理配对请求
@Override
public void onReceive(Context context, Intent intent) {
    String action = intent.getAction();
    if (BluetoothDevice.ACTION_PAIRING_REQUEST.equals(action)) {
        BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
        // 拦截系统默认配对流程，避免干扰
        abortBroadcast();
        
        try {
            // 强制设置配对类型为PIN输入模式
            Method setPairingVariantMethod = BluetoothDevice.class.getMethod("setPairingVariant", int.class);
            setPairingVariantMethod.invoke(device, BluetoothDevice.PAIRING_VARIANT_PIN);
            
            // 此时设备应显示PIN码，需弹出自定义输入框让用户输入，再调用setPin
            // 示例：假设用户输入PIN为"1234"
            byte[] pinBytes = "1234".getBytes("UTF-8");
            boolean result = device.setPin(pinBytes);
            
            // Android 13普通应用无法直接调用setPairingConfirmation，改用广播发送确认信号
            Intent confirmIntent = new Intent(BluetoothDevice.ACTION_PAIRING_CONFIRMATION);
            confirmIntent.putExtra(BluetoothDevice.EXTRA_DEVICE, device);
            confirmIntent.putExtra(BluetoothDevice.EXTRA_CONFIRMATION, true);
            context.sendBroadcast(confirmIntent);
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 配置完整权限 #

确保应用在AndroidManifest.xml中声明必要权限，并在运行时动态申请：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- Android 12及以下扫描需位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="31" />

3. 调整Gatt连接参数 #

调用connectGatt()时设置autoConnect为false，建立直接连接以触发正确配对流程：

BluetoothGatt gatt = mDevice.connectGatt(context, false, gattCallback);

4. 匹配第三方应用的GATT交互逻辑 #

部分BLE设备需要在连接后读写特定GATT服务/特征才会触发PIN显示。可以用nRF Connect等工具抓取第三方应用的GATT交互日志，对比自研应用的流程，补充缺失的特征读写操作。

关键注意事项 #

• Android 13限制普通应用调用setPairingConfirmation()，发送ACTION_PAIRING_CONFIRMATION广播是可行替代方案
• 不要依赖系统自动触发的绑定状态，主动调用createBond()能更精准控制配对流程

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