gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-11 12:14:30 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/docs/zh-CN/godot/input.md
gewuyou ebbef321ad feat(input): 新增统一输入抽象与Godot集成 
- 新增输入绑定 DTO、设备上下文和 UI 语义桥接契约。

- 实现 Game 默认输入绑定存储、动作映射和 UI 分发桥接。

- 落地 Godot InputMap 适配、测试覆盖与配套文档。

- 更新 ai-plan 恢复点、worktree 映射与采用入口。
2026-05-10 22:29:26 +08:00

2.2 KiB
Raw Blame History

title, description
title description
Godot 输入集成 说明 GFramework.Godot 如何把 InputMap 与 project.godot InputActions 接到新的框架输入抽象。

Godot 输入集成

GFramework.Godot.Input 负责把 Godot 的 InputMap 绑定表接到 GFramework.Game.Abstractions.Input 契约。

当前入口是：

  • GodotInputBindingStore
    • 读取 / 写回 InputMap
    • 导出 / 导入 InputBindingSnapshot
    • 把逻辑动作名继续桥接给 Game 层的绑定存储与 UI 输入分发语义

与 project.godot 的关系

当前推荐组合仍然是：

  • project.godot
    • 继续定义动作名与默认绑定
  • GFramework.Godot.SourceGenerators
    • 继续生成 InputActions.* 字符串常量
  • GFramework.Godot.Input.GodotInputBindingStore
    • 负责运行时读取默认绑定、替换主绑定、恢复默认和导出快照

这意味着新的运行时输入系统不会替代 InputActions，而是把它当作稳定动作名入口继续使用。

最小接入方式

using GFramework.Game.Abstractions.Input;
using GFramework.Game.Input;
using GFramework.Godot.Generated;
using GFramework.Godot.Input;

var bindingStore = new GodotInputBindingStore();

var acceptBinding = bindingStore.GetBindings(InputActions.UiAccept);
bindingStore.SetPrimaryBinding(
    InputActions.UiAccept,
    new InputBindingDescriptor(
        InputDeviceKind.KeyboardMouse,
        InputBindingKind.Key,
        "key:32",
        "Space"));

如果你已经有 UiRouterBase，还可以继续把动作名桥接到 UI 语义：

var dispatcher = new UiInputDispatcher(new UiInputActionMap(), uiRouter);
dispatcher.TryDispatch(InputActions.UiCancel);

当前边界

  • GodotInputBindingStore 当前聚焦 InputMap 绑定管理，而不是完整 gameplay input runtime
  • 当前测试覆盖的是纯托管后端语义，不是 Godot 原生 InputEvent 对象在所有宿主中的行为差异
  • 设备品牌、手柄图标、震动预设等宿主特化体验仍应视为 Godot 专属扩展，不上升到 Game.Abstractions

相关主题