React Native蓝牙通信开发实战指南-代码聚汇网

React Native蓝牙通信开发实战指南

颜不糙

1. React Native蓝牙通信核心原理剖析

在移动应用开发领域，蓝牙通信一直是硬件交互的重要桥梁。React Native作为跨平台框架，通过JavaScript桥接原生模块的方式实现了蓝牙功能调用。其核心架构分为三层：JavaScript业务层负责指令组装和数据处理，Native桥接层进行协议转换，最底层的操作系统蓝牙协议栈（Android的BlueDroid/iOS的CoreBluetooth）实际处理射频信号。

蓝牙4.0+规范中，通信主要依赖GATT（通用属性协议）模型。每个外设设备包含若干服务（Service），每个服务下又有特征值（Characteristic）。开发者通过读写这些特征值实现数据交换。React Native社区主流的react-native-ble-plx库正是基于此模型封装，支持：

设备扫描与连接管理
服务/特征值发现
数据读写与通知订阅
MTU协商（最大传输单元）

关键提示：Android和iOS在蓝牙权限处理上有显著差异。Android需要动态申请位置权限（用于设备发现），而iOS需要在Info.plist中声明蓝牙使用描述。

2. 开发环境搭建与基础配置

2.1 必备工具链准备

React Native 0.63+（支持Hermes引擎）
蓝牙调试工具（推荐nRF Connect或LightBlue）
安卓设备需支持BLE 4.0+（API 18+）
iOS设备需iPhone 4S及以上机型

安装核心依赖库：

bash复制yarn add react-native-ble-plx
cd ios && pod install

2.2 平台差异化配置

Android配置：

在AndroidManifest.xml添加权限：

xml复制<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

在build.gradle中设置minSdkVersion至少为21：

gradle复制android {
    defaultConfig {
        minSdkVersion 21
    }
}

iOS配置：

在Info.plist中添加：

xml复制<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限连接设备</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>需要蓝牙权限连接设备</string>

3. 蓝牙指令发送全流程实现

3.1 设备扫描与连接

javascript复制import { BleManager } from 'react-native-ble-plx';

const manager = new BleManager();

// 扫描设备
const subscription = manager.onStateChange((state) => {
  if (state === 'PoweredOn') {
    manager.startDeviceScan(null, null, (error, device) => {
      if (error) {
        console.error('扫描失败', error);
        return;
      }
      console.log(`发现设备: ${device.name} | ID: ${device.id}`);
    });
    setTimeout(() => manager.stopDeviceScan(), 5000);
  }
}, true);

// 连接设备
async function connectToDevice(deviceId) {
  const device = await manager.connectToDevice(deviceId);
  await device.discoverAllServicesAndCharacteristics();
  return device;
}

3.2 指令发送核心方法

蓝牙指令通常需要转换为ArrayBuffer格式发送。以下是典型实现：

javascript复制async function sendCommand(deviceId, serviceUUID, characteristicUUID, command) {
  try {
    // 字符串转字节数组
    const buffer = Buffer.from(command, 'ascii');
    const base64Value = buffer.toString('base64');
    
    const device = await manager.connectToDevice(deviceId);
    await device.writeCharacteristicWithResponseForService(
      serviceUUID,
      characteristicUUID,
      base64Value
    );
    console.log('指令发送成功');
  } catch (error) {
    console.error('发送失败:', error);
  }
}

3.3 数据接收处理

订阅特征值变化通知：

javascript复制async function subscribeToCharacteristic(deviceId, serviceUUID, characteristicUUID) {
  const device = await manager.connectToDevice(deviceId);
  const subscription = device.monitorCharacteristicForService(
    serviceUUID,
    characteristicUUID,
    (error, characteristic) => {
      if (error) {
        console.error('监听错误', error);
        return;
      }
      const value = characteristic.value;
      const decoded = Buffer.from(value, 'base64').toString();
      console.log('收到数据:', decoded);
    }
  );
  return subscription;
}

4. 实战案例：智能硬件控制

假设我们要控制一个支持BLE的智能灯泡，其协议定义如下：

服务UUID: 0000FFE0-0000-1000-8000-00805F9B34FB
特征UUID: 0000FFE1-0000-1000-8000-00805F9B34FB
指令格式:
- 开灯: AA 01 01
- 关灯: AA 01 00
- 调亮度(50%): AA 02 32

实现代码：

javascript复制// 开灯指令
const turnOn = async (deviceId) => {
  const command = new Uint8Array([0xAA, 0x01, 0x01]);
  await sendCommand(
    deviceId,
    '0000FFE0-0000-1000-8000-00805F9B34FB',
    '0000FFE1-0000-1000-8000-00805F9B34FB',
    command
  );
};

// 亮度调节
const setBrightness = async (deviceId, percent) => {
  const value = Math.min(100, Math.max(0, percent));
  const command = new Uint8Array([0xAA, 0x02, value]);
  await sendCommand(...);
};

5. 性能优化与调试技巧

5.1 连接参数优化

通过修改连接间隔（Connection Interval）提升吞吐量：

javascript复制await device.requestConnectionPriority(2); // 0:平衡 1:高 2:低延迟

5.2 MTU协商

增加单次数据传输量：

javascript复制const mtu = await device.requestMTU(185); // 最大值视平台而定

5.3 常见问题排查表

现象	可能原因	解决方案
扫描不到设备	Android未开启定位	检查位置权限和GPS开关
连接立即断开	设备已达最大连接数	重启目标设备
写入失败	特征值不可写	检查characteristic.properties
数据乱码	编码格式不匹配	统一使用Base64中转
iOS连接超时	未在后台模式配置	添加bluetooth-central后台模式

6. 高级应用场景实现

6.1 大数据分片传输

当发送超过MTU限制的数据时，需要实现分片协议：

javascript复制async function sendLargeData(deviceId, serviceUUID, charUUID, data) {
  const chunkSize = 20; // 小于MTU的值
  for (let i = 0; i < data.length; i += chunkSize) {
    const chunk = data.slice(i, i + chunkSize);
    await sendCommand(deviceId, serviceUUID, charUUID, chunk);
    await new Promise(resolve => setTimeout(resolve, 50)); // 防止堵塞
  }
}

6.2 多设备同步控制

使用队列管理多个设备指令：

javascript复制class BluetoothQueue {
  constructor() {
    this.queue = [];
    this.isProcessing = false;
  }

  addTask(task) {
    this.queue.push(task);
    this.process();
  }

  async process() {
    if (this.isProcessing) return;
    this.isProcessing = true;
    
    while (this.queue.length > 0) {
      const task = this.queue.shift();
      try {
        await task();
      } catch (e) {
        console.error('任务执行失败:', e);
      }
    }
    
    this.isProcessing = false;
  }
}

7. 安全实践与功耗优化

7.1 通信加密方案

使用AES加密指令数据：

javascript复制import CryptoJS from 'crypto-js';

const encryptCommand = (command, key) => {
  const encrypted = CryptoJS.AES.encrypt(command, key).toString();
  return Buffer.from(encrypted).toString('base64');
};

在设备端实现对应解密逻辑

7.2 低功耗策略

及时取消扫描：manager.stopDeviceScan()
断开空闲连接：device.cancelConnection()
使用autoConnect参数平衡重连策略

javascript复制await manager.connectToDevice(deviceId, {
  autoConnect: false // 设为true可后台保持连接
});

8. 测试验证体系

8.1 单元测试方案

使用jest模拟蓝牙模块：

javascript复制jest.mock('react-native-ble-plx', () => ({
  BleManager: jest.fn().mockImplementation(() => ({
    connectToDevice: jest.fn(),
    writeCharacteristicWithResponseForService: jest.fn()
  }))
}));

8.2 真机调试技巧

Android开启蓝牙HCI日志：

bash复制adb shell setprop persist.bluetooth.btsnooplogmode full
adb pull /data/misc/bluetooth/logs/btsnoop_hci.log

iOS使用PacketLogger工具捕获BLE流量
使用Wireshark分析蓝牙协议数据包