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

简介

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

快速开始

列出当前连接的游戏手柄

import 'package:gamepads/gamepads.dart';

void main() async {
  final gamepads = await Gamepads.list();
  for (var gamepad in gamepads) {
    print('Gamepad ID: ${gamepad.id}, Name: ${gamepad.name}');
  }
}

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

import 'package:gamepads/gamepads.dart';

void main() {
  Gamepads.events.listen((event) {
    print('Gamepad ID: ${event.gamepadId}, Key: ${event.key}, Value: ${event.value}');
  });
}

监听特定游戏手柄的输入事件

import 'package:gamepads/gamepads.dart';

void main() async {
  final gamepads = await Gamepads.list();
  if (gamepads.isNotEmpty) {
    final specificGamepadId = gamepads.first.id;
    Gamepads.eventsByGamepad(specificGamepadId).listen((event) {
      print('Gamepad ID: ${event.gamepadId}, Key: ${event.key}, Value: ${event.value}');
    });
  }
}

GamepadEvent 数据类

class GamepadEvent {
  final String gamepadId; // 游戏手柄ID
  final int timestamp; // 时间戳，以毫秒为单位
  final KeyType type; // 键类型
  final String key; // 平台相关的键标识符
  final double value; // 键的当前值
}

下一步计划

该库仍在开发中，API可能会有所变化。我们计划添加更多功能，例如：

• 监听游戏手柄的连接/断开事件
• 获取游戏手柄的当前状态
• 添加对Web和移动设备的支持

如果你有兴趣帮助开发，请通过GitHub或我们的Discord服务器联系我们。

Android集成

Android实现要求应用程序的Activity将输入事件（和输入设备）转发给插件。以下是一个干净的Flutter项目的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
    }
}

支持项目

你可以通过以下方式支持该项目：

• 给项目点个星⭐
• 通过OpenCollective捐赠
• 通过GitHub Sponsors赞助
• 在Patreon上成为赞助者

以上内容展示了如何在Flutter应用中使用gamepads插件来处理游戏手柄输入。希望这个示例对你有所帮助！