Flutter硬件访问插件hid4flutter的使用

Flutter硬件访问插件hid4flutter的使用

hid4flutter

• 版本: 0.1.3
• 许可证: MIT License

hid4flutter 是一个用于从Flutter应用与HID（Human Interface Device）设备进行通信的Flutter插件。

使用说明

安装

在Flutter项目中安装hid4flutter，请按照以下步骤操作：

1. 在pubspec.yaml文件中添加以下依赖项：

dependencies:
  hid4flutter: ^0.1.3

替换^0.0.3为最新版本号。

1. 运行以下命令以安装依赖项：

flutter pub get

1. 在Dart代码中导入hid4flutter包：

import 'package:hid4flutter/hid4flutter.dart';

1. 按照文档和示例集成并通信HID设备到您的Flutter应用程序。

注意事项

在Linux平台上，需要手动安装hidapi。执行以下命令：

sudo apt-get install libhidapi-hidraw0

目前hidapi在构建此库时不会被编译到Linux上。这个问题将在未来版本中解决。

示例代码

下面是一个完整的示例代码，展示了如何使用hid4flutter插件来获取连接的设备列表、发送输出报告以及接收输入报告。

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
          colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
          useMaterial3: true),
      home: const DeviceListScreen(),
    );
  }
}

class DeviceListScreen extends StatefulWidget {
  const DeviceListScreen({super.key});

  [@override](/user/override)
  DeviceListScreenState createState() => DeviceListScreenState();
}

class DeviceListScreenState extends State<DeviceListScreen> {
  List<HidDevice> devices = [];

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

  Future<void> _loadConnectedDevices() async {
    try {
      List<HidDevice> connectedDevices = await Hid.getDevices();
      setState(() {
        devices = connectedDevices;
      });
    } catch (e) {
      // ignore: avoid_print
      print('Error getting connected devices: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Connected Devices'),
      ),
      body: _buildDeviceList(),
      floatingActionButton: FloatingActionButton(
        onPressed: () => {
          _loadConnectedDevices(),
        },
        tooltip: 'Refresh',
        child: const Icon(Icons.refresh),
      ),
    );
  }

  Widget _buildDeviceList() {
    if (devices.isEmpty) {
      return const Center(
        child: Text('No connected devices'),
      );
    }

    return ListView.builder(
      itemCount: devices.length,
      itemBuilder: (context, index) {
        HidDevice device = devices[index];
        return Card(
          margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
          child: ListTile(
            title: Text('Device $index'),
            subtitle: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Text('Path: ${device.path}'),
                Text('Vendor ID: 0x${device.vendorId.toRadixString(16)}'),
                Text('Product ID: 0x${device.productId.toRadixString(16)}'),
                Text('Serial Number: ${device.serialNumber}'),
                Text('Release Number: ${device.releaseNumber}'),
                Text('Manufacturer: ${device.manufacturer}'),
                Text('Product Name: ${device.productName}'),
                Text('Usage Page: 0x${device.usagePage.toRadixString(16)}'),
                Text('Usage: 0x${device.usage.toRadixString(16)}'),
                Text('Interface Number: ${device.interfaceNumber}'),
                Text('Bus Type: ${device.busType}'),
              ],
            ),
          ),
        );
      },
    );
  }
}