flutter如何使用ble插件

我正在使用Flutter开发一个需要蓝牙功能的APP，但不太清楚如何正确集成和使用BLE插件。具体有以下问题：

  1. 应该选择哪个BLE插件比较稳定（如flutter_blue_plus还是其他）？
  2. 如何配置Android/iOS的权限和依赖项？
  3. 能否提供一个简单的代码示例演示设备扫描、连接和数据读写？
  4. 在真机调试时有哪些常见坑需要注意？
    希望有经验的大佬能分享下具体步骤或最佳实践！
2 回复

使用Flutter的BLE插件（如flutter_blue）步骤：

  1. 在pubspec.yaml添加依赖。
  2. 导入包并请求蓝牙权限。
  3. 扫描设备、连接并读写特征值。
  4. 处理连接状态和数据交互。

更多关于flutter如何使用ble插件的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中使用BLE插件进行蓝牙低功耗通信，推荐使用 flutter_blue_plus 插件（它是flutter_blue的升级版，支持空安全和更多功能）。以下是详细步骤：

1. 添加依赖

在 pubspec.yaml 中添加：

dependencies:
  flutter_blue_plus: ^1.12.0

运行 flutter pub get 安装。

2. 配置权限

Android

在 android/app/src/main/AndroidManifest.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" />
<!-- Android 12+ 需要额外权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

iOS

在 ios/Runner/Info.plist 中添加：

<dict>
  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>需要蓝牙权限以连接设备</string>
</dict>

3. 基本使用代码

import 'package:flutter_blue_plus/flutter_blue_plus.dart';

class BleController {
  // 扫描设备
  void startScan() {
    FlutterBluePlus.startScan(timeout: Duration(seconds: 10));
    FlutterBluePlus.scanResults.listen((results) {
      for (ScanResult r in results) {
        print('发现设备: ${r.device.name} | ${r.device.remoteId}');
      }
    });
  }

  // 停止扫描
  void stopScan() {
    FlutterBluePlus.stopScan();
  }

  // 连接设备
  Future<void> connect(BluetoothDevice device) async {
    await device.connect();
    print("已连接: ${device.remoteId}");
    
    // 发现服务
    List<BluetoothService> services = await device.discoverServices();
    for (var service in services) {
      print("服务 UUID: ${service.uuid}");
    }
  }

  // 读写特征值
  Future<void> readCharacteristic(BluetoothCharacteristic characteristic) async {
    List<int> value = await characteristic.read();
    print('特征值数据: $value');
  }
}

4. 注意事项

  • Android 12+ 需要动态申请 BLUETOOTH_SCAN 和 BLUETOOTH_CONNECT 权限
  • iOS 需要在 Info.plist 中声明蓝牙使用原因
  • 真机测试时需要开启手机蓝牙功能
  • 不同设备的服务和特征值UUID可能不同

5. 常用操作

  • 检查蓝牙状态：FlutterBluePlus.isAvailable
  • 获取已连接设备：FlutterBluePlus.connectedDevices
  • 断开连接：device.disconnect()

建议查看官方文档获取最新API和完整示例：https://pub.dev/packages/flutter_blue_plus

回到顶部