mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-11 12:14:30 +08:00
5f9589ed3c
- 修复 InputBindingStore 只读查询会污染导出快照的问题 - 修复 Godot 输入绑定导入时未清理残留动作绑定的问题 - 补充输入运行时与 Godot backend 的 XML 契约说明和 README 入口 - 更新 ai-plan 跟踪并补充针对 PR #346 的回归测试
42 lines
1.5 KiB
C#
42 lines
1.5 KiB
C#
// Copyright (c) 2025-2026 GeWuYou
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
using GFramework.Game.Abstractions.Input;
|
|
|
|
namespace GFramework.Game.Input;
|
|
|
|
/// <summary>
|
|
/// 提供可由宿主侧更新的默认输入设备跟踪器。
|
|
/// </summary>
|
|
public sealed class InputDeviceTracker : IInputDeviceTracker
|
|
{
|
|
/// <summary>
|
|
/// 初始化输入设备跟踪器。
|
|
/// </summary>
|
|
public InputDeviceTracker()
|
|
{
|
|
CurrentDevice = new InputDeviceContext(InputDeviceKind.Unknown);
|
|
}
|
|
|
|
/// <inheritdoc />
|
|
/// <remarks>
|
|
/// 该属性不提供额外同步原语。
|
|
/// 宿主应在同一输入线程内调用 <see cref="Update" /> 并读取当前值，例如 Godot 的主线程或输入事件线程。
|
|
/// </remarks>
|
|
public InputDeviceContext CurrentDevice { get; private set; }
|
|
|
|
/// <summary>
|
|
/// 使用新的宿主设备上下文覆盖当前状态。
|
|
/// </summary>
|
|
/// <param name="context">新的设备上下文。</param>
|
|
/// <remarks>
|
|
/// 该方法设计给宿主输入线程串行调用。
|
|
/// 如果宿主需要跨线程读取设备上下文，应在外层提供自己的同步策略，而不是依赖此类型完成可见性保证。
|
|
/// </remarks>
|
|
/// <exception cref="ArgumentNullException">当 <paramref name="context" /> 为 <see langword="null" /> 时抛出。</exception>
|
|
public void Update(InputDeviceContext context)
|
|
{
|
|
CurrentDevice = context ?? throw new ArgumentNullException(nameof(context));
|
|
}
|
|
}
|