如何使用react-native-ble-plx实现无需用户交互的蓝牙程序化配对

核心逻辑说明 #

react-native-ble-plx 本身仅封装了 BLE 通信相关能力，没有内置系统配对接口，自动配对能力需要结合不同端的系统原生 API 实现。

安卓端实现步骤 #

• 本地预置目标设备白名单：提前将需要配对的设备名称、MAC 地址、固定 PIN 码存储在应用本地配置中
• 扫描到目标设备后，调用安卓原生蓝牙接口触发配对，无需用户输入密码，对应原生代码示例如下：

// 安卓原生自动配对工具方法
public boolean autoPair(BluetoothDevice device, String presetPin) {
    try {
        // 注入预置PIN码，屏蔽用户输入弹窗
        boolean setPinSuccess = device.setPin(presetPin.getBytes());
        if (setPinSuccess) {
            return device.createBond();
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return false;
}

• 注册系统配对状态广播，确认配对成功后，再通过 react-native-ble-plx 建立设备连接

iOS 端实现说明 #

iOS 系统出于安全限制，不允许应用侧直接预置 PIN 码触发自动配对，首次配对必须弹出系统配对弹窗。如果你的设备支持自定义 BLE 鉴权逻辑，可以通过特征值读写携带预置密码的方式完成业务层校验，替代系统级配对流程，无需用户输入密码。

跨端流程整合（JS 侧代码示例） #

import { BleManager } from 'react-native-ble-plx';
import { NativeModules, Platform } from 'react-native';

const bleManager = new BleManager();
// 本地预置配置
const TARGET_DEVICE_NAME = "你的目标设备名称";
const PRESET_PAIR_PIN = "123456";

// 设备扫描逻辑
bleManager.startDeviceScan(null, null, (error, device) => {
    if (error) return;
    if (device.name === TARGET_DEVICE_NAME) {
        bleManager.stopDeviceScan();
        // 安卓端优先调用原生自动配对逻辑
        if (Platform.OS === 'android') {
            NativeModules.BleAutoPairUtil.autoPair(device.id, PRESET_PAIR_PIN)
                .then(pairResult => {
                    if (pairResult) {
                        connectDevice(device.id)
                    }
                })
        } else {
            // iOS 端直接走连接+自定义鉴权逻辑
            connectDevice(device.id)
        }
    }
})

// 设备连接逻辑
async function connectDevice(deviceId) {
    const targetDevice = await bleManager.connectToDevice(deviceId);
    await targetDevice.discoverAllServicesAndCharacteristics();
    // 后续业务读写逻辑
}

注意事项 #

• 安卓 12 及以上版本需要申请 BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT、BLUETOOTH_SCAN 权限，否则无法调用配对相关 API
• 部分定制安卓系统可能会屏蔽应用触发自动配对的接口，需要提前做兼容性测试
• 若你的 BLE 设备不需要系统级配对，仅需业务层鉴权，可以直接在特征值读写时携带预置密码完成校验，无需调用原生配对接口

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