feat(input): 添加 IInputIconService 接口及 InputDeviceType 枚举以支持按键图标管理
This commit is contained in:
40
Assets/_Game/Scripts/Input/Icons/IInputIconService.cs
Normal file
40
Assets/_Game/Scripts/Input/Icons/IInputIconService.cs
Normal file
@@ -0,0 +1,40 @@
|
||||
using System;
|
||||
using UnityEngine;
|
||||
|
||||
namespace BaseGames.UI
|
||||
{
|
||||
/// <summary>
|
||||
/// 按键图标服务接口。
|
||||
/// 根据当前输入设备和玩家实际绑定(含改键),返回对应的按键 Sprite。
|
||||
/// 通过 ServiceLocator 注册/查找,与 UI 层完全解耦。
|
||||
/// </summary>
|
||||
public interface IInputIconService
|
||||
{
|
||||
/// <summary>当前活跃输入设备类型。</summary>
|
||||
InputDeviceType CurrentDevice { get; }
|
||||
|
||||
/// <summary>
|
||||
/// 查询指定 Action(如 "Interact")在当前设备上的按键图标。
|
||||
/// 若找不到图标(资源未配置)返回 null。
|
||||
/// </summary>
|
||||
Sprite GetActionIcon(string actionName);
|
||||
|
||||
/// <summary>
|
||||
/// 查询指定 Action 在当前设备上的有效绑定路径(含改键后的路径)。
|
||||
/// 例如:"<Keyboard>/e"、"<Gamepad>/buttonSouth"。
|
||||
/// </summary>
|
||||
string GetActionEffectivePath(string actionName);
|
||||
|
||||
/// <summary>
|
||||
/// 根据固定绑定路径(如 "<Keyboard>/space")在当前图标集中查找图标。
|
||||
/// 不受改键影响,适合装饰性按键说明。找不到时返回 null。
|
||||
/// </summary>
|
||||
Sprite GetPathIcon(string bindingPath);
|
||||
|
||||
/// <summary>
|
||||
/// 当设备切换或玩家改键后触发。
|
||||
/// 订阅此事件的 UI 组件应在回调中刷新图标显示。
|
||||
/// </summary>
|
||||
event Action OnIconSetChanged;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user