mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
4bd9853ec1
新增 `IInputTranslator` 接口用于解耦原始输入与游戏事件的转换逻辑。 在 `InputSystem` 中增加注册、注销和处理原始输入的方法，支持优先级控制。 重构 `GodotInputBridge`，移除原有硬编码翻译逻辑，改为通过 `HandleRaw` 调用转换器处理。 新增 `GodotInputTranslator` 实现 `IInputTranslator`，负责将 Godot 输入事件翻译为游戏事件。 模块初始化时自动注册该转换器至输入系统。
64 lines
2.3 KiB
C#
64 lines
2.3 KiB
C#
using GFramework.Core.architecture;
|
||
using GFramework.Core.constants;
|
||
using GFramework.Game.input;
|
||
using GFramework.Godot.architecture;
|
||
using GFramework.Godot.extensions;
|
||
using Godot;
|
||
|
||
namespace GFramework.Godot.input;
|
||
|
||
/// <summary>
|
||
/// Godot输入模块类，用于管理Godot游戏引擎中的输入系统
|
||
/// </summary>
|
||
/// <typeparam name="T">架构类型，必须继承自Architecture且具有无参构造函数</typeparam>
|
||
public sealed class GodotInputModule<T> : AbstractGodotModule<T>
|
||
where T : Architecture<T>, new()
|
||
{
|
||
private GodotInputBridge? _node;
|
||
/// <summary>
|
||
/// 架构锚点节点的唯一标识名称
|
||
/// 用于在Godot场景树中创建和查找架构锚点节点
|
||
/// </summary>
|
||
private const string GodotInputBridgeName = $"__${GFrameworkConstants.FrameworkName}__GodotInputBridge__";
|
||
/// <summary>
|
||
/// 获取模块对应的节点对象
|
||
/// </summary>
|
||
/// <exception cref="InvalidOperationException">当节点尚未创建时抛出异常</exception>
|
||
public override Node Node => _node
|
||
?? throw new InvalidOperationException("Node not created yet");
|
||
private InputSystem _inputSystem = null!;
|
||
|
||
/// <summary>
|
||
/// 当模块被附加到架构时调用此方法
|
||
/// </summary>
|
||
/// <param name="architecture">要附加到的架构实例</param>
|
||
public override void OnAttach(Architecture<T> architecture)
|
||
{
|
||
// 创建Godot输入桥接节点并绑定输入系统
|
||
_node = new GodotInputBridge { Name = GodotInputBridgeName};
|
||
_node.Bind(_inputSystem);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 当模块从架构中分离时调用此方法
|
||
/// </summary>
|
||
public override void OnDetach()
|
||
{
|
||
// 释放节点资源并清理引用
|
||
Node.QueueFreeX();
|
||
_node = null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 安装模块时调用此方法，用于获取所需的系统组件
|
||
/// </summary>
|
||
/// <param name="architecture">当前架构实例</param>
|
||
public override void Install(IArchitecture architecture)
|
||
{
|
||
// 从架构中获取输入系统实例
|
||
_inputSystem = architecture.GetSystem<InputSystem>()!;
|
||
// 注册输入转换器
|
||
_inputSystem.RegisterTranslator(new GodotInputTranslator());
|
||
}
|
||
}
|