mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-11 20:38:58 +08:00
5f9589ed3c
- 修复 InputBindingStore 只读查询会污染导出快照的问题 - 修复 Godot 输入绑定导入时未清理残留动作绑定的问题 - 补充输入运行时与 Godot backend 的 XML 契约说明和 README 入口 - 更新 ai-plan 跟踪并补充针对 PR #346 的回归测试
48 lines
2.2 KiB
C#
48 lines
2.2 KiB
C#
// Copyright (c) 2025-2026 GeWuYou
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
using GFramework.Game.Abstractions.Input;
|
|
|
|
namespace GFramework.Godot.Input;
|
|
|
|
/// <summary>
|
|
/// 定义 `GodotInputBindingStore` 依赖的最小 `InputMap` 后端能力。
|
|
/// </summary>
|
|
internal interface IGodotInputMapBackend
|
|
{
|
|
/// <summary>
|
|
/// 获取当前 `InputMap` 中的动作名。
|
|
/// </summary>
|
|
/// <returns>动作名列表；永远不会返回 <see langword="null" />。</returns>
|
|
IReadOnlyList<string> GetActionNames();
|
|
|
|
/// <summary>
|
|
/// 获取指定动作的框架绑定描述集合。
|
|
/// </summary>
|
|
/// <param name="actionName">动作名称，不能为 <see langword="null" /> 或空白字符串。</param>
|
|
/// <returns>框架绑定描述集合；永远不会返回 <see langword="null" />。</returns>
|
|
/// <exception cref="ArgumentException">当 <paramref name="actionName" /> 为 <see langword="null" /> 或空白字符串时抛出。</exception>
|
|
IReadOnlyList<InputBindingDescriptor> GetBindings(string actionName);
|
|
|
|
/// <summary>
|
|
/// 用给定绑定集合替换动作当前绑定。
|
|
/// </summary>
|
|
/// <param name="actionName">动作名称，不能为 <see langword="null" /> 或空白字符串。</param>
|
|
/// <param name="bindings">新的绑定集合，不能为 <see langword="null" />，但可以为空集合。</param>
|
|
/// <exception cref="ArgumentException">当 <paramref name="actionName" /> 为 <see langword="null" /> 或空白字符串时抛出。</exception>
|
|
/// <exception cref="ArgumentNullException">当 <paramref name="bindings" /> 为 <see langword="null" /> 时抛出。</exception>
|
|
void SetBindings(string actionName, IReadOnlyList<InputBindingDescriptor> bindings);
|
|
|
|
/// <summary>
|
|
/// 将指定动作恢复为项目默认绑定。
|
|
/// </summary>
|
|
/// <param name="actionName">动作名称，不能为 <see langword="null" /> 或空白字符串。</param>
|
|
/// <exception cref="ArgumentException">当 <paramref name="actionName" /> 为 <see langword="null" /> 或空白字符串时抛出。</exception>
|
|
void ResetAction(string actionName);
|
|
|
|
/// <summary>
|
|
/// 将所有动作恢复为项目默认绑定。
|
|
/// </summary>
|
|
void ResetAll();
|
|
}
|