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

gamepads 是一个Flutter插件，用于处理多个平台上的游戏手柄（或摇杆）输入。它支持同时连接多个游戏手柄，并会自动检测和监听新的连接。

快速开始

列出所有已连接的游戏手柄

使用 list 方法可以列出当前所有已连接的游戏手柄：

final gamepads = await Gamepads.list();

该方法返回一个包含 GamepadController 对象的列表，每个对象都有一个唯一的 id 和用户可见的 name。

监听所有游戏手柄的输入事件

通过监听 events 流，可以接收到所有游戏手柄的输入事件：

Gamepads.events.listen((event) {
  // 处理事件
});

如果你想监听特定游戏手柄的事件，可以使用 eventsByGamepad 方法。

输入事件的数据结构

输入事件由 GamepadEvent 类描述，包含以下字段：

• gamepadId: 触发事件的游戏手柄的ID。
• timestamp: 事件触发的时间戳，以自纪元以来的毫秒数表示。
• type: 触发的按键类型，由 KeyType 枚举定义。
• key: 平台相关的按键标识符。
• value: 按键的当前值（例如，对于模拟输入，可能是0到1之间的浮点数）。

Android集成

在Android平台上，需要将输入事件转发给插件。可以在 MainActivity 中实现如下代码：

package [YOUR_PACKAGE_NAME]

import android.hardware.input.InputManager
import android.os.Handler
import android.view.InputDevice
import android.view.KeyEvent
import android.view.MotionEvent
import io.flutter.embedding.android.FlutterActivity
import org.flame_engine.gamepads_android.GamepadsCompatibleActivity

class MainActivity: FlutterActivity(), GamepadsCompatibleActivity {
    var keyListener: ((KeyEvent) -> Boolean)? = null
    var motionListener: ((MotionEvent) -> Boolean)? = null

    override fun dispatchGenericMotionEvent(motionEvent: MotionEvent): Boolean {
        return motionListener?.invoke(motionEvent) ?: false
    }
    
    override fun dispatchKeyEvent(keyEvent: KeyEvent): Boolean {
        return keyListener?.invoke(keyEvent) ?: false
    }

    override fun registerInputDeviceListener(
      listener: InputManager.InputDeviceListener, handler: Handler?) {
        val inputManager = getSystemService(INPUT_SERVICE) as InputManager
        inputManager.registerInputDeviceListener(listener, null)
    }

    override fun registerKeyEventHandler(handler: (KeyEvent) -> Boolean) {
        keyListener = handler
    }

    override fun registerMotionEventHandler(handler: (MotionEvent) -> Boolean) {
        motionListener = handler
    }
}

示例代码

下面是一个完整的示例应用程序，展示了如何使用 gamepads 插件：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:gamepads/gamepads.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Gamepads Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

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

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  StreamSubscription<GamepadEvent>? _subscription;

  List<GamepadController> _gamepads = [];
  List<GamepadEvent> _lastEvents = [];
  bool loading = false;

  Future<void> _getValue() async {
    setState(() => loading = true);
    final response = await Gamepads.list();
    setState(() {
      _gamepads = response;
      loading = false;
    });
  }

  void _clear() {
    setState(() => _lastEvents = []);
  }

  @override
  void initState() {
    super.initState();
    _subscription = Gamepads.events.listen((event) {
      setState(() {
        final newEvents = [
          event,
          ..._lastEvents,
        ];
        if (newEvents.length > 3) {
          newEvents.removeRange(3, newEvents.length);
        }
        _lastEvents = newEvents;
      });
    });
  }

  @override
  void dispose() {
    _subscription?.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Gamepads Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text('Last Events:'),
            ..._lastEvents.map((e) => Text(e.toString())),
            TextButton(
              onPressed: _clear,
              child: const Text('clear events'),
            ),
            const SizedBox(height: 16),
            TextButton(
              onPressed: _getValue,
              child: const Text('listGamepads()'),
            ),
            const Text('Gamepads:'),
            if (loading)
              const CircularProgressIndicator()
            else ...[
              for (final gamepad in _gamepads) ...[
                Text('${gamepad.id} - ${gamepad.name}'),
                Text('  Analog inputs: ${gamepad.state.analogInputs}'),
                Text('  Button inputs: ${gamepad.state.buttonInputs}'),
              ],
            ],
          ],
        ),
      ),
    );
  }
}

这个示例应用程序展示了如何列出所有已连接的游戏手柄，并实时显示最近的输入事件。你可以根据需要扩展和修改这个示例来满足你的具体需求。