Flutter游戏手柄支持插件win_gamepad的使用

win_gamepad

一个用于Windows的Flutter插件，用于接收支持XInput的游戏控制器输入。该插件使用XInput游戏控制器API来获取游戏控制器的输入。

安装

在pubspec.yaml文件中添加以下依赖项以使用此插件：

dependencies:
  win_gamepad: ^版本号

然后运行以下命令以更新依赖项：

flutter pub get

使用

导入插件

在Dart文件中导入win_gamepad插件：

import 'package:win_gamepad/gamepad.dart';

初始化游戏手柄

创建并初始化游戏手柄实例，默认ID为0，自动振动功能默认为false：

Gamepad gamepad = Gamepad();

[@override](/user/override)
void initState() {
  super.initState();
  
  // 初始化游戏手柄，并选择第一个可用设备（ID为0）
  gamepad.initialize(onCallback: (gamepadState) {
    print(gamepadState); // 打印游戏手柄状态
    setState(() {}); // 更新UI
  });
}

获取可用的游戏手柄ID

通过以下方法获取可用设备的ID列表：

gamepad.getAvaibleDevices(); // 返回可用设备的ID列表

选择特定的游戏手柄

通过指定ID选择特定的游戏手柄：

gamepad.selectGamepad(id); // 替换 `id` 为所需设备的ID

启用自动振动

启用自动振动功能后，游戏手柄的触发器会自动振动：

gamepad.setAutoVibration(true); // 启用自动振动

手动振动

手动控制游戏手柄的振动效果：

gamepad.setVibration(leftMotorSpeed, rightMotorSpeed);

// 参数说明：
// leftMotorSpeed: 左马达速度（范围：0.0 到 1.0）
// rightMotorSpeed: 右马达速度（范围：0.0 到 1.0）

显示游戏手柄布局

为了方便测试，可以使用GamepadLayout小部件来显示游戏手柄的布局：

GamepadLayout(gamepad: gamepad,)

示例代码

以下是一个完整的示例代码，展示如何使用win_gamepad插件：

import 'package:flutter/material.dart';

import 'package:win_gamepad/gamepad.dart';
import 'package:win_gamepad/gamepad_layout.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Gamepad gamepad = Gamepad();

  [@override](/user/override)
  void initState() {
    super.initState();
    
    // 初始化游戏手柄
    gamepad.initialize(onCallback: (gamepadState) {
      setState(() {}); // 更新UI
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件 win_gamepad'), // 中文标题
        ),
        body: Center(
          child: Column(
            children: [
              // 显示游戏手柄布局
              Opacity(
                opacity: 1,
                child: GamepadLayout(
                  gamepad: gamepad,
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}