universal_ble_backend 是一个用于 Flutter 的蓝牙通信插件，它提供了一个跨平台的接口来与蓝牙设备进行通信。这个插件可以帮助开发者更容易地实现蓝牙设备的扫描、连接、数据读写等操作。以下是如何使用 universal_ble_backend 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 universal_ble_backend 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  universal_ble_backend: ^最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 universal_ble_backend 插件。

import 'package:universal_ble_backend/universal_ble_backend.dart';

3. 初始化蓝牙

在使用蓝牙功能之前，需要先初始化蓝牙适配器。

final ble = UniversalBleBackend();
await ble.initialize();

4. 扫描蓝牙设备

你可以使用 startScan 方法来扫描附近的蓝牙设备。

ble.startScan();
ble.scanResults.listen((results) {
  for (var result in results) {
    print('Found device: ${result.device.name}, RSSI: ${result.rssi}');
  }
});

5. 连接蓝牙设备

扫描到设备后，你可以使用 connect 方法来连接设备。

await ble.connect(deviceId);

6. 发现服务和特征

连接成功后，你可以发现设备的服务和特征。

final services = await ble.discoverServices(deviceId);
for (var service in services) {
  print('Service: ${service.uuid}');
  for (var characteristic in service.characteristics) {
    print('Characteristic: ${characteristic.uuid}');
  }
}

7. 读取和写入数据

你可以使用 readCharacteristic 和 writeCharacteristic 方法来读取和写入特征值。

// 读取特征值
final value = await ble.readCharacteristic(deviceId, serviceUuid, characteristicUuid);
print('Read value: $value');

// 写入特征值
await ble.writeCharacteristic(deviceId, serviceUuid, characteristicUuid, [0x01, 0x02]);

8. 监听特征值变化

你可以使用 setNotification 方法来监听特征值的变化。

ble.setNotification(deviceId, serviceUuid, characteristicUuid, true);
ble.onValueChanged.listen((event) {
  if (event.deviceId == deviceId && event.characteristicUuid == characteristicUuid) {
    print('Value changed: ${event.value}');
  }
});

9. 断开连接

当你不再需要连接设备时，可以断开连接。

await ble.disconnect(deviceId);

10. 停止扫描

如果你不再需要扫描设备，可以停止扫描。

ble.stopScan();

11. 释放资源

在应用退出时，记得释放蓝牙资源。

ble.dispose();

注意事项

• 在使用蓝牙功能时，确保在 Android 和 iOS 上已经获取了相应的权限。
• 在 iOS 上，需要在 Info.plist 文件中添加蓝牙权限描述。

<key>NSBluetoothAlwaysUsageDescription</key>
<string>我们需要访问蓝牙以连接设备</string>

示例代码

以下是一个简单的示例代码，展示了如何使用 universal_ble_backend 插件进行蓝牙设备的扫描、连接和数据读写。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: BluetoothScreen(),
    );
  }
}

class BluetoothScreen extends StatefulWidget {
  [@override](/user/override)
  _BluetoothScreenState createState() => _BluetoothScreenState();
}

class _BluetoothScreenState extends State<BluetoothScreen> {
  final ble = UniversalBleBackend();
  List<ScanResult> devices = [];
  String? connectedDeviceId;

  [@override](/user/override)
  void initState() {
    super.initState();
    initBluetooth();
  }

  Future<void> initBluetooth() async {
    await ble.initialize();
    ble.startScan();
    ble.scanResults.listen((results) {
      setState(() {
        devices = results;
      });
    });
  }

  Future<void> connectToDevice(String deviceId) async {
    await ble.connect(deviceId);
    setState(() {
      connectedDeviceId = deviceId;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Bluetooth Example'),
      ),
      body: ListView.builder(
        itemCount: devices.length,
        itemBuilder: (context, index) {
          final device = devices[index].device;
          return ListTile(
            title: Text(device.name ?? 'Unknown Device'),
            subtitle: Text(device.id),
            onTap: () => connectToDevice(device.id),
          );
        },
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    ble.dispose();
    super.dispose();
  }
}