输入、音频与界面 — 文档

一个动作，多种输入

InputManager 使用整数动作标识符和存储绑定的 unordered_multimap。一个动作可以关联多个输入。只要其中一个绑定处于按下状态，Pressed(action) 就返回真。

参考修订中的绑定类型如下：

struct Keyboard {
  sf::Keyboard::Scan key;
};
struct Mouse {
  sf::Mouse::Button button;
};
struct Gamepad {
  GamepadButton button;
  int id = 0;
};
struct Axis {
  sf::Joystick::Axis axis;
  float threshold = 0.5f;
  int id = 0;
};

using Binding = std::variant<Keyboard, Mouse, Gamepad, Axis>;

这些类型属于 Input 命名空间。查询返回的是当前状态，不会自动检测刚刚按下的瞬间。需要处理离散事件时，场景还可以使用 OnEvent。

轴值除以 100 进行归一化，然后与配置的正阈值或负阈值比较。Engine 在切换场景时清除绑定，因此各游戏必须在开始时重新设置自己的绑定。

手柄与光标

代码中包含 Xbox 和 PlayStation 的逻辑按钮表。识别到 Microsoft 厂商标识时选择 Xbox 表，其他情况使用 PlayStation 表。这种启发式判断不能保证所有手柄具有相同映射。

Xbox 表中没有为 L2/R2 扳机分配按钮；在该按钮映射中，它们被标为不可用。轴是独立的绑定类型。

CursorManager 可以通过摇杆移动光标，并遵循 joystickDeadzone。它也能将鼠标位置转换为视图坐标。GuiManager 将逻辑 South 按钮转换成控件的点击事件。

全局快捷键

输入	操作
F12	保存 PNG 截图。
R	重启活动场景。
Escape / 手柄 Start	切换暂停覆盖层。
M / 手柄 Select	请求 `Menu`；本文所述修订没有注册该场景。

快捷键由 EngineVisitor 处理。失去焦点会暂停场景。重新获得焦点后，只有覆盖层不再打开时才会恢复。

参考修订中的音频

AudioManager 通过 SFML 提供全局音量和监听器的位置、方向。ResourceManager 提供声音缓冲区和音乐对象；场景拥有音源并控制播放。

void AudioManager::SetGlobalVolume(float volume) {
  sf::Listener::setGlobalVolume(volume);
}

在此修订中，各个游戏在 OnPause 和 OnCleanup 中协调自身音频。文档所述代码没有可配置的总线混音器或音频编辑器。

本地开发中的改动

审查时发现 AudioGroup.h 和 AudioGroup.cpp 尚未包含在参考提交中。它们按场景组织音源、区分 Music/Effect 通道，并记录暂停前正在播放的音源。

本地也有关于共享冷却时钟的改动。这些实现确实存在，但不属于本指南的公开示例。不要在期望链接提交包含这些 API 的情况下使用它们。

TGUI 界面

GuiManager 将 TGUI 与 SFML 窗口连接，加载 Content/Themes/Dark.txt，应用 Relidux.otf 字体，启用 Tab 导航，并提供添加或移除控件的方法。

覆盖层通过 magic_enum 根据 OverlaySelection 创建按钮。选择结果只被消费一次，随后由 Engine 执行对应操作。GUI 在场景后处理完成后绘制。