Flutter蓝牙通信插件universal_ble的使用

发布于 1周前 作者 h691938207 来自 Flutter

Flutter蓝牙通信插件universal_ble的使用

一、简介

universal_ble 是一个跨平台(Android/iOS/macOS/Windows/Linux/Web)的Bluetooth Low Energy (BLE) 插件,适用于Flutter应用。它提供了丰富的功能来满足不同的开发需求。

pub package

你可以通过 在线体验 来感受这个插件的强大之处(需浏览器支持Web Bluetooth)。

二、特性

  • 扫描设备:可以启动和停止扫描,并且可以通过过滤器精确找到目标设备。
  • 连接管理:能够建立与断开蓝牙设备的连接。
  • 服务发现:获取已连接设备的服务列表。
  • 数据读写:对指定特征进行数据的读取或写入操作。
  • 配对处理:实现设备间的配对及取消配对。
  • 蓝牙状态检测:检查当前蓝牙是否可用以及监听其状态变化。
  • 命令队列控制:支持全局队列、每设备独立队列或者完全并行执行。
  • 超时设置:为所有命令设定默认超时时间。
  • UUID格式无关性:无论输入何种格式的UUID,都能正确解析。

三、使用方法

1. 添加依赖

pubspec.yaml 文件中添加如下内容:

dependencies:
  universal_ble: ^latest_version # 替换为最新版本号

然后在需要使用的Dart文件顶部导入库:

import 'package:universal_ble/universal_ble.dart';

2. 基础用法示例

(1)初始化并开始扫描

确保蓝牙处于开启状态后开始扫描附近设备:

// 检查蓝牙是否已开启
if (await UniversalBle.getBluetoothAvailabilityState() == AvailabilityState.poweredOn) {
  // 设置扫描结果回调函数
  UniversalBle.onScanResult = (bleDevice) {
    print('Found device: ${bleDevice.name}');
  };

  // 开始扫描
  UniversalBle.startScan();
}

(2)连接设备

当接收到感兴趣的设备时,可以通过其ID建立连接:

String deviceId = bleDevice.deviceId;
UniversalBle.connect(deviceId);

(3)发现服务

连接成功后,下一步就是查找该设备提供的所有服务:

await UniversalBle.discoverServices(deviceId);

(4)读写特征值

针对某个具体的服务及其特征,我们可以执行相应的读写操作:

// 写入数据到特征
await UniversalBle.writeValue(deviceId, serviceId, characteristicId, Uint8List.fromList([0x01]));

// 订阅通知
await UniversalBle.setNotifiable(deviceId, serviceId, characteristicId, BleInputProperty.notification);

// 接收来自特征的通知消息
UniversalBle.onValueChange = (deviceId, characteristicId, value) {
  print('Received data from $characteristicId: ${hex.encode(value)}');
};

(5)配对

对于某些场景下可能需要先完成配对才能进一步交互:

bool? isPaired = await UniversalBle.pair(deviceId);
print('Pairing result: $isPaired');

(6)处理蓝牙状态变化

为了更好地用户体验,建议监听蓝牙状态的变化:

UniversalBle.onAvailabilityChange = (state) {
  if (state == AvailabilityState.poweredOn) {
    print('Bluetooth has been turned on.');
  } else {
    print('Bluetooth is not available.');
  }
};

3. 完整示例代码

下面是一个完整的Demo程序,展示了如何结合上述步骤创建一个简单的Flutter应用程序来搜索附近的BLE设备并显示它们的信息。

import 'package:flutter/material.dart';
import 'package:universal_ble/universal_ble.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Universal BLE Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: DeviceScanner(),
    );
  }
}

class DeviceScanner extends StatefulWidget {
  @override
  _DeviceScannerState createState() => _DeviceScannerState();
}

class _DeviceScannerState extends State<DeviceScanner> {
  final List<BleDevice> _devices = [];

  @override
  void initState() {
    super.initState();

    // 监听扫描结果
    UniversalBle.onScanResult = (device) {
      setState(() {
        _devices.add(device);
      });
    };

    // 检查蓝牙是否可用
    checkBluetoothAvailability();
  }

  Future<void> checkBluetoothAvailability() async {
    AvailabilityState state = await UniversalBle.getBluetoothAvailabilityState();
    if (state == AvailabilityState.poweredOn) {
      startScanning();
    } else {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Please turn on Bluetooth and try again.')),
      );
    }
  }

  void startScanning() {
    UniversalBle.startScan();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Nearby Devices'),
      ),
      body: ListView.builder(
        itemCount: _devices.length,
        itemBuilder: (context, index) {
          final device = _devices[index];
          return ListTile(
            title: Text(device.name ?? 'Unknown Device'),
            subtitle: Text(device.address),
          );
        },
      ),
    );
  }

  @override
  void dispose() {
    UniversalBle.stopScan();
    super.dispose();
  }
}

此段代码创建了一个名为 MyApp 的Flutter应用程序,其中包含一个名为 DeviceScanner 的页面。该页面会尝试启动蓝牙扫描,并将发现的设备名称和地址展示在一个列表视图中。同时,在页面销毁时会停止正在进行的扫描任务。

希望这份指南对你有所帮助!如果你还有其他问题,请随时提问。


更多关于Flutter蓝牙通信插件universal_ble的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter蓝牙通信插件universal_ble的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,以下是一个使用 universal_ble 插件进行蓝牙通信的 Flutter 代码示例。这个示例展示了如何扫描蓝牙设备、连接到设备以及读写数据。

首先,确保你在 pubspec.yaml 文件中添加了 universal_ble 依赖:

dependencies:
  flutter:
    sdk: flutter
  universal_ble: ^x.y.z  # 请替换为最新版本号

然后运行 flutter pub get 来安装依赖。

接下来是 Flutter 代码示例:

import 'package:flutter/material.dart';
import 'package:universal_ble/universal_ble.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  UniversalBleManager? bleManager;
  List<DiscoveredDevice> discoveredDevices = [];
  ConnectedDevice? connectedDevice;

  @override
  void initState() {
    super.initState();
    bleManager = UniversalBleManager.builder()
      .setLogLevel(BleLogLevel.verbose)
      .build();

    bleManager?.scanForDevices(
      allowDuplicatesKey: true,
      scanMode: ScanMode.lowLatency,
      matchNum: 1,
      scanCallback: (result) {
        setState(() {
          discoveredDevices = result;
        });
      },
      errorCallback: (error) {
        print("Scan error: $error");
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter Bluetooth Communication'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            children: [
              Text('Discovered Devices:'),
              Expanded(
                child: ListView.builder(
                  itemCount: discoveredDevices.length,
                  itemBuilder: (context, index) {
                    var device = discoveredDevices[index];
                    return ListTile(
                      title: Text(device.name ?? 'Unknown Device'),
                      trailing: IconButton(
                        icon: Icon(Icons.connect_without_contact),
                        onPressed: () {
                          connectToDevice(device);
                        },
                      ),
                    );
                  },
                ),
              ),
              if (connectedDevice != null)
                Column(
                  children: [
                    Text('Connected Device: ${connectedDevice?.name ?? 'Unknown'}'),
                    ElevatedButton(
                      onPressed: () {
                        writeDataToDevice();
                      },
                      child: Text('Write Data'),
                    ),
                  ],
                ),
            ],
          ),
        ),
      ),
    );
  }

  void connectToDevice(DiscoveredDevice device) {
    bleManager?.connectToDevice(
      deviceId: device.id,
      connectionTimeout: 5000,
      connectionCallback: (result) {
        setState(() {
          connectedDevice = result;
        });
      },
      disconnectCallback: (device) {
        setState(() {
          connectedDevice = null;
        });
      },
      errorCallback: (error) {
        print("Connection error: $error");
      },
    );
  }

  void writeDataToDevice() {
    if (connectedDevice != null) {
      var serviceUuid = 'your-service-uuid';  // 替换为你的服务 UUID
      var characteristicUuid = 'your-characteristic-uuid';  // 替换为你的特征 UUID

      bleManager?.writeCharacteristicForDevice(
        deviceId: connectedDevice!.id,
        serviceUuid: serviceUuid,
        characteristicUuid: characteristicUuid,
        data: Uint8List.fromList([0x01, 0x02, 0x03]),  // 示例数据
        writeType: CharacteristicWriteType.withResponse,
        writeCallback: (result) {
          print("Write success: $result");
        },
        errorCallback: (error) {
          print("Write error: $error");
        },
      );
    }
  }

  @override
  void dispose() {
    bleManager?.destroy();
    super.dispose();
  }
}

注意事项:

  1. UUID:确保你使用正确的服务 UUID 和特征 UUID。这些 UUID 通常是蓝牙设备文档或规范中提供的。
  2. 权限:确保在 AndroidManifest.xmlInfo.plist 中添加了蓝牙相关的权限。
  3. 错误处理:在实际应用中,添加更多的错误处理和用户反馈以提高用户体验。

这个示例展示了如何使用 universal_ble 插件进行蓝牙设备扫描、连接和通信。根据你的具体需求,你可能需要调整代码中的 UUID、数据格式和处理逻辑。

回到顶部