ble_controller 是一个用于在 Flutter 应用中控制蓝牙设备的插件。它提供了与蓝牙设备进行通信的功能，包括扫描、连接、发送和接收数据等。以下是如何使用 ble_controller 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 ble_controller 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  ble_controller: ^1.0.0  # 请使用最新版本

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

2. 导入插件

在你的 Dart 文件中导入 ble_controller 插件：

import 'package:ble_controller/ble_controller.dart';

3. 初始化蓝牙控制器

在使用蓝牙功能之前，需要初始化 BleController：

BleController bleController = BleController();

4. 检查蓝牙状态

在开始扫描或连接设备之前，检查设备的蓝牙状态：

bool isBluetoothEnabled = await bleController.isBluetoothEnabled();
if (!isBluetoothEnabled) {
  // 请求用户打开蓝牙
  await bleController.enableBluetooth();
}

5. 扫描设备

使用 scanForDevices 方法扫描附近的蓝牙设备：

List<BluetoothDevice> devices = await bleController.scanForDevices();

BluetoothDevice 通常包含设备的名称、地址等信息。

6. 连接设备

选择要连接的设备后，使用 connectToDevice 方法进行连接：

await bleController.connectToDevice(deviceAddress);

deviceAddress 是设备的 MAC 地址。

7. 发送和接收数据

连接成功后，可以使用 writeCharacteristic 和 readCharacteristic 方法发送和接收数据：

// 发送数据
await bleController.writeCharacteristic(serviceUuid, characteristicUuid, data);

// 接收数据
List<int> receivedData = await bleController.readCharacteristic(serviceUuid, characteristicUuid);

serviceUuid 和 characteristicUuid 是蓝牙服务的 UUID 和特征的 UUID，data 是要发送的数据。

8. 断开连接

在完成操作后，断开与设备的连接：

await bleController.disconnectFromDevice();

9. 处理异常

在使用蓝牙功能时，可能会遇到各种异常情况，建议使用 try-catch 块来处理异常：

try {
  await bleController.connectToDevice(deviceAddress);
} catch (e) {
  print('连接失败: $e');
}

10. 权限处理

在 Android 上，使用蓝牙功能需要相应的权限。确保在 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"/>

此外，还需要在运行时请求位置权限：

import 'package:permission_handler/permission_handler.dart';

void requestPermissions() async {
  if (await Permission.location.isDenied) {
    await Permission.location.request();
  }
}

示例代码

以下是一个简单的示例，展示了如何使用 ble_controller 插件扫描和连接蓝牙设备：

import 'package:flutter/material.dart';
import 'package:ble_controller/ble_controller.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> {
  BleController bleController = BleController();
  List<BluetoothDevice> devices = [];

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

  Future<void> initBluetooth() async {
    bool isBluetoothEnabled = await bleController.isBluetoothEnabled();
    if (!isBluetoothEnabled) {
      await bleController.enableBluetooth();
    }
    await scanDevices();
  }

  Future<void> scanDevices() async {
    List<BluetoothDevice> scannedDevices = await bleController.scanForDevices();
    setState(() {
      devices = scannedDevices;
    });
  }

  Future<void> connectToDevice(String deviceAddress) async {
    try {
      await bleController.connectToDevice(deviceAddress);
      print('连接成功');
    } catch (e) {
      print('连接失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('蓝牙控制示例'),
      ),
      body: ListView.builder(
        itemCount: devices.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(devices[index].name),
            subtitle: Text(devices[index].address),
            onTap: () => connectToDevice(devices[index].address),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: scanDevices,
        child: Icon(Icons.search),
      ),
    );
  }
}