当前位置：首页 > news >正文

React Native BLE Manager入门指南：快速构建跨平台蓝牙应用

news 2026/4/21 4:01:39

React Native BLE Manager入门指南：快速构建跨平台蓝牙应用

【免费下载链接】react-native-ble-managerReact Native BLE communication module项目地址: https://gitcode.com/gh_mirrors/re/react-native-ble-manager

React Native BLE Manager是一个强大的蓝牙通信模块，专为React Native开发者设计，可帮助你轻松构建跨平台的蓝牙低功耗（BLE）移动应用。无论是智能家居控制、健康设备连接还是物联网项目，这个库都能提供简单高效的解决方案，让你快速实现设备间的无线通信。

📱 什么是React Native BLE Manager？

React Native BLE Manager是一个开源库，它为React Native应用提供了完整的蓝牙低功耗通信功能。通过封装原生平台（Android和iOS）的BLE API，它让开发者能够用JavaScript编写跨平台的蓝牙应用，无需深入了解复杂的原生代码。

React Native BLE Manager蓝牙图标，代表应用的核心功能

核心特点：

跨平台支持：同时支持Android和iOS系统
简单API：直观的方法调用，降低开发难度
完整功能：涵盖扫描、连接、读写数据等所有BLE操作
自动链接：支持React Native的自动链接功能，简化集成流程

🚀 快速安装步骤

1. 安装依赖包

首先，使用npm或yarn安装React Native BLE Manager：

npm i --save react-native-ble-manager

2. 配置平台权限

BLE功能需要特定的权限配置，以下是Android和iOS平台的必要设置：

Android配置

编辑android/app/src/main/AndroidManifest.xml文件，添加必要的权限：

<!-- 添加蓝牙相关权限 --> <uses-permission android:name="android.permission.BLUETOOTH" tools:remove="android:maxSdkVersion" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" tools:remove="android:maxSdkVersion" /> <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" /> <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

iOS配置

编辑Info.plist文件，添加蓝牙权限描述：

<!-- iOS蓝牙权限 --> <key>NSBluetoothAlwaysUsageDescription</key> <string>需要蓝牙权限以连接和通信BLE设备</string> <key>NSBluetoothPeripheralUsageDescription</key> <string>需要蓝牙权限以连接和通信BLE设备</string>

3. 请求运行时权限

除了配置文件中的权限声明，还需要在应用运行时动态请求权限：

async function requestBluetoothPermissions() { if (Platform.OS === 'android') { const permissions = []; if (Platform.Version >= 23 && Platform.Version <= 30) { permissions.push(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION); } else if (Platform.Version >= 31) { permissions.push( PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN, PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT, ); } const granted = await PermissionsAndroid.requestMultiple(permissions); return Object.values(granted).every( result => result === PermissionsAndroid.RESULTS.GRANTED, ); } return true; }

🔧 基本使用流程

使用React Native BLE Manager开发蓝牙功能通常遵循以下步骤：

1. 初始化模块

在使用任何BLE功能之前，需要先初始化模块：

import BleManager from 'react-native-ble-manager'; // 初始化BLE模块 BleManager.start({ showAlert: false }).then(() => { console.log("BLE模块初始化成功"); });

2. 扫描蓝牙设备

初始化完成后，可以开始扫描周围的BLE设备：

// 扫描设备，持续5秒 BleManager.scan({ serviceUUIDs: [], seconds: 5 }).then(() => { console.log("扫描已开始"); }); // 监听设备发现事件 BleManager.onDiscoverPeripheral((peripheral) => { console.log("发现设备:", peripheral); });

3. 连接到设备

找到目标设备后，可以与其建立连接：

// 连接到设备 BleManager.connect(peripheral.id) .then(() => { console.log("设备连接成功"); // 连接成功后获取设备服务 return BleManager.retrieveServices(peripheral.id); }) .then((peripheralInfo) => { console.log("设备服务信息:", peripheralInfo); }) .catch((error) => { console.log("连接失败:", error); });

4. 读写数据

连接成功并获取服务后，就可以进行数据的读写操作了：

// 读取特征值 BleManager.read(peripheralId, serviceUUID, characteristicUUID) .then((data) => { console.log("读取到的数据:", data); }) .catch((error) => { console.log("读取失败:", error); }); // 写入数据 const dataToWrite = [0x01, 0x02, 0x03]; // 示例数据 BleManager.write(peripheralId, serviceUUID, characteristicUUID, dataToWrite) .then(() => { console.log("数据写入成功"); }) .catch((error) => { console.log("写入失败:", error); });

5. 断开连接

使用完毕后，记得断开与设备的连接：

// 断开连接 BleManager.disconnect(peripheralId) .then(() => { console.log("设备已断开连接"); }) .catch((error) => { console.log("断开连接失败:", error); });

💡 实用功能与技巧

启用通知功能

对于需要实时数据更新的场景，可以启用特征值通知：

// 启用通知 BleManager.startNotification(peripheralId, serviceUUID, characteristicUUID) .then(() => { console.log("通知已启用"); }) .catch((error) => { console.log("启用通知失败:", error); }); // 监听通知事件 BleManager.onDidUpdateValueForCharacteristic((result) => { console.log("收到通知数据:", result.value); });

检查蓝牙状态

在进行蓝牙操作前，检查设备蓝牙状态是个好习惯：

// 检查蓝牙状态 BleManager.checkState().then((state) => { console.log(`当前蓝牙状态: ${state}`); if (state === 'on') { // 蓝牙已开启，可以进行操作 } else { // 蓝牙未开启，提示用户开启 if (Platform.OS === 'android') { BleManager.enableBluetooth() .then(() => console.log("用户已开启蓝牙")) .catch(() => console.log("用户拒绝开启蓝牙")); } } });