Flutter游戏手柄控制插件n_gamepad的使用

Flutter游戏手柄控制插件n_gamepad的使用

简介

n_gamepad 是一个Flutter插件，用于监听游戏控制器的输入。它允许你在Android手机上接收来自游戏手柄配件的输入，并提供了实现多设备功能的框架。

功能

• 支持监听来自游戏手柄的输入。
• 提供了实现多设备功能的框架，如视频中所示（视频链接已移除）。

入门指南

为了确保插件在Android平台上正常工作，你需要在 FlutterActivity 中覆盖Android的标准游戏手柄输入设置。具体步骤如下：

class MainActivity : FlutterActivity() {
    private lateinit var view: View

    override fun onStart() {
        super.onStart()

        // 获取Flutter视图
        view = window.findViewById<ViewGroup>(FLUTTER_VIEW_ID).getChildAt(0)
    }

    override fun dispatchKeyEvent(event: KeyEvent?): Boolean {
        // 将按键事件传递给Flutter视图
        return view.dispatchKeyEvent(event)
    }
}

使用方法

你可以通过 Gamepad.instance 访问游戏手柄的输入，并为特定按钮、方向键、摇杆和触发器分配处理程序。要重置单个输入处理程序，可以调用相同的方法而不指定任何函数。以下是一些示例代码：

// 为A按钮设置按下和释放处理程序
Gamepad.instance.assignButtonListener(Button.a, onPress: (event) {}, onRelease: (event) {});

// 为B按钮重置按下处理程序并设置释放处理程序
Gamepad.instance.assignButtonListener(Button.b, onRelease: (event) {});

// 为右摇杆设置使用处理程序
Gamepad.instance.assignJoystickListener(Hand.right, onUse: (event) {});

// 重置B按钮的按下和释放处理程序
Gamepad.instance.assignButtonListener(Button.b);

// 重置所有输入控制的处理程序
Gamepad.instance.resetControls();

完整示例Demo

以下是一个完整的示例应用，展示了如何使用 n_gamepad 插件来监听游戏手柄的输入，并在界面上显示最新的按钮状态。

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: MyHomePage(),
    );
  }
}

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

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final map = <Enum, bool>{
    Button.a: false,
    Button.b: false,
    Button.x: false,
    Button.y: false,
    Control.dpad: false,
  };

  String text = '';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        leading: IconButton(
          icon: const Icon(Icons.refresh),
          onPressed: resetGamepadListeners,
        ),
        title: const Text('Gamepad Plugin Example'),
        actions: [
          for (var element in map.keys)
            if (element is Button)
              IconButton(
                onPressed: () => toggleGamepadButtonListener(element),
                icon: Text(
                  element.name.toUpperCase(),
                  style: TextStyle(
                    fontWeight: map[element] == true ? FontWeight.bold : null,
                  ),
                ),
              ),
        ],
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text('Last button state:'),
            Text(text, style: Theme.of(context).textTheme.headlineSmall),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: toggleGamepadDpadListener,
        child: Icon(
          map[Control.dpad] == true ? Icons.gamepad : Icons.gamepad_outlined,
        ),
      ),
    );
  }

  void resetGamepadListeners() {
    Gamepad.instance.resetControls();

    setState(() {
      for (var element in map.keys) {
        map[element] = false;
      }
    });
  }

  void toggleGamepadButtonListener(Button button) {
    setState(() {
      if (map[button] == true) {
        map[button] = Gamepad.instance.assignButtonListener(button);
      } else {
        map[button] = Gamepad.instance.assignButtonListener(
          button,
          onPress: onGamepadButtonEvent,
          onRelease: onGamepadButtonEvent,
        );
      }
    });
  }

  void onGamepadButtonEvent(ButtonEvent event) {
    setState(() => text = '$event');
  }

  void toggleGamepadDpadListener() {
    setState(() {
      if (map[Control.dpad] == true) {
        map[Control.dpad] = Gamepad.instance.assignDpadListener();
      } else {
        map[Control.dpad] = Gamepad.instance.assignDpadListener(
          onUse: onGamepadDpadEvent,
        );
      }
    });
  }

  void onGamepadDpadEvent(DpadEvent event) {
    setState(() => text = '$event');
  }
}