Flutter USB设备访问插件dart_usb的使用

dart_usb 是一个用于在 Flutter 应用中访问 USB 设备的插件。它允许你与连接的 USB 设备进行通信，包括读取和写入数据。以下是如何使用 dart_usb 插件的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  dart_usb: ^0.1.0  # 请确保使用最新版本

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

2. 初始化插件

在你的 Dart 代码中，首先需要初始化 dart_usb 插件：

import 'package:dart_usb/dart_usb.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await DartUsb().initialize();
  runApp(MyApp());
}

3. 发现 USB 设备

你可以使用 DartUsb 类来发现连接的 USB 设备：

void listUsbDevices() async {
  List<UsbDevice> devices = await DartUsb().getDevices();
  for (var device in devices) {
    print('Device: ${device.vendorId}:${device.productId}');
  }
}

4. 打开设备并通信

要与特定的 USB 设备通信，你需要打开设备并获取其接口和端点：

void communicateWithDevice(UsbDevice device) async {
  await device.open();
  
  // 获取设备的接口
  List<UsbInterface> interfaces = await device.getInterfaces();
  for (var interface in interfaces) {
    print('Interface: ${interface.id}');
    
    // 获取接口的端点
    List<UsbEndpoint> endpoints = await interface.getEndpoints();
    for (var endpoint in endpoints) {
      print('Endpoint: ${endpoint.address}');
      
      // 读取或写入数据
      if (endpoint.direction == UsbEndpointDirection.in) {
        List<int> data = await endpoint.read();
        print('Read data: $data');
      } else if (endpoint.direction == UsbEndpointDirection.out) {
        await endpoint.write([0x01, 0x02, 0x03]);
        print('Write data successful');
      }
    }
  }
  
  await device.close();
}

5. 权限处理

在某些平台上（如 Android），访问 USB 设备需要特定的权限。你可能需要在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.USB_PERMISSION" />

并且，你需要在 Flutter 应用中请求 USB 权限：

void requestUsbPermission() async {
  bool granted = await DartUsb().requestPermission();
  if (granted) {
    print('USB permission granted');
  } else {
    print('USB permission denied');
  }
}

6. 处理 USB 设备的热插拔

你还可以监听 USB 设备的连接和断开事件：

void listenUsbEvents() {
  DartUsb().onDeviceConnected.listen((UsbDevice device) {
    print('Device connected: ${device.vendorId}:${device.productId}');
  });

  DartUsb().onDeviceDisconnected.listen((UsbDevice device) {
    print('Device disconnected: ${device.vendorId}:${device.productId}');
  });
}

7. 关闭设备

完成与 USB 设备的通信后，记得关闭设备：

await device.close();

8. 处理错误

在实际使用中，你可能会遇到各种错误（如权限问题、设备未连接等），因此建议在使用 dart_usb 时添加适当的错误处理：

try {
  await device.open();
  // 其他操作
} catch (e) {
  print('Error: $e');
}

9. 完整示例

以下是一个完整的示例，展示如何发现和与 USB 设备通信：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await DartUsb().initialize();
  runApp(MyApp());
}

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

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

class _UsbDeviceScreenState extends State<UsbDeviceScreen> {
  List<UsbDevice> devices = [];

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

  void listUsbDevices() async {
    List<UsbDevice> deviceList = await DartUsb().getDevices();
    setState(() {
      devices = deviceList;
    });
  }

  void communicateWithDevice(UsbDevice device) async {
    try {
      await device.open();
      List<UsbInterface> interfaces = await device.getInterfaces();
      for (var interface in interfaces) {
        List<UsbEndpoint> endpoints = await interface.getEndpoints();
        for (var endpoint in endpoints) {
          if (endpoint.direction == UsbEndpointDirection.in) {
            List<int> data = await endpoint.read();
            print('Read data: $data');
          } else if (endpoint.direction == UsbEndpointDirection.out) {
            await endpoint.write([0x01, 0x02, 0x03]);
            print('Write data successful');
          }
        }
      }
      await device.close();
    } catch (e) {
      print('Error: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('USB Devices'),
      ),
      body: ListView.builder(
        itemCount: devices.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text('Device: ${devices[index].vendorId}:${devices[index].productId}'),
            onTap: () => communicateWithDevice(devices[index]),
          );
        },
      ),
    );
  }
}