游戏引擎 / 系统课时
切换主菜单暂停菜单与输入焦点
切换主菜单暂停菜单与输入焦点
把主菜单、暂停菜单和设置页接到同一套游戏状态:进入暂停后,场景停止按游戏时间推进,移动与攻击输入失效,但鼠标、键盘和手柄仍能操作菜单;关闭菜单时恢复原来的输入与焦点。
学习目标
- 用明确状态控制菜单可见性、
Time.timeScale和鼠标锁定。 - 在
Gameplay与UIAction Map 之间切换,避免暂停后仍能攻击。 - 让设置页正确返回来源菜单,并为手柄指定初始焦点。
准备界面与输入资产
以下步骤适用于 Unity 6(6000.0 及之后)和新版 Input System,界面使用运行时 UI Toolkit,不混用 uGUI。
- 在
Window > Package Manager安装Input System;到Edit > Project Settings > Player > Other Settings > Configuration,将Active Input Handling设为Input System Package (New)。 - 在
Edit > Project Settings > Input System Package创建或指定项目级 Input Actions 资产。保留UI地图及其Navigate、Submit、Cancel、Point、Click等默认动作和类型,确保方向键/手柄摇杆可导航、Enter/手柄南键可确认。 - 在同一资产新增
Gameplay地图,保留角色已有的Move和Attack,添加Pause(类型Button),绑定<Keyboard>/escape和<Gamepad>/start;给UI/Cancel绑定 Escape、手柄东键,并可增加手柄 Start。 - 将此资产赋给角色的
PlayerInput > Actions,Default Map设为Gameplay。角色移动和战斗脚本须读取PlayerInput管理的动作,不能另行从始终启用的项目级 Gameplay 动作直接驱动角色。 - 用 UI Builder 建立一个全屏
UIDocument,包含三个VisualElement容器,分别命名main-menu、pause-menu、settings-menu。主菜单内建start-button、main-settings-button;暂停菜单内建resume-button、pause-settings-button;设置页内建back-button。这些控件均使用Button,在 Inspector 给UIDocument指定Panel Settings和Source Asset。
Unity 6 的纯 UI Toolkit 运行时界面可使用内置事件系统和项目级 UI 动作,不必额外建立 EventSystem;若场景混用 uGUI,应使用 EventSystem 加 InputSystemUIInputModule,不能继续保留旧的 StandaloneInputModule。
明确状态与焦点去向
| 状态 | 显示内容 | Time.timeScale |
PlayerInput 当前地图 |
默认焦点 |
|---|---|---|---|---|
| Main | 主菜单 | 0 | UI | 开始游戏 |
| Game | 游戏画面 | 1 | Gameplay | 无菜单焦点 |
| Pause | 暂停菜单 | 0 | UI | 继续游戏 |
| SettingsMain | 设置页 | 0 | UI | 返回 |
| SettingsPause | 设置页 | 0 | UI | 返回 |
设置页必须记住它从主菜单还是暂停菜单进入,否则按“返回”可能意外恢复游戏。Time.timeScale = 0 只暂停依赖缩放时间的更新,不能自动关闭 Input Action 回调,因此必须同时切换地图。

编写状态控制组件
新建 MenuFlow.cs,挂在 UIDocument 所在物体上,把场景中带 PlayerInput 的角色拖进 Player Input 引用。脚本按上述 UXML 名称查询控件,监听菜单按钮及 Gameplay/Pause,用 NavigationCancelEvent 处理 UI 的取消键。
using UnityEngine;
using UnityEngine.InputSystem;
using UnityEngine.UIElements;
[RequireComponent(typeof(UIDocument))]
public sealed class MenuFlow : MonoBehaviour
{
[SerializeField] private PlayerInput playerInput;
private enum Page { Main, Game, Pause, SettingsMain, SettingsPause }
private Page page;
private VisualElement root, main, pause, settings;
private Button start, mainSettings, resume, pauseSettings, back;
private InputAction pauseAction;
private int changedFrame;
private void OnEnable()
{
root = GetComponent<UIDocument>().rootVisualElement;
main = root.Q<VisualElement>("main-menu");
pause = root.Q<VisualElement>("pause-menu");
settings = root.Q<VisualElement>("settings-menu");
start = root.Q<Button>("start-button");
mainSettings = root.Q<Button>("main-settings-button");
resume = root.Q<Button>("resume-button");
pauseSettings = root.Q<Button>("pause-settings-button");
back = root.Q<Button>("back-button");
start.clicked += StartGame;
mainSettings.clicked += OpenMainSettings;
resume.clicked += ResumeGame;
pauseSettings.clicked += OpenPauseSettings;
back.clicked += Back;
root.RegisterCallback<NavigationCancelEvent>(OnCancel);
pauseAction = playerInput.actions.FindAction("Gameplay/Pause", true);
pauseAction.performed += OnPause;
Show(Page.Main);
}
private void StartGame() => Show(Page.Game);
private void ResumeGame() => Show(Page.Game);
private void OpenMainSettings() => Show(Page.SettingsMain);
private void OpenPauseSettings() => Show(Page.SettingsPause);
private void Back()
{
if (page == Page.SettingsMain) Show(Page.Main);
else if (page == Page.SettingsPause) Show(Page.Pause);
}
private void OnPause(InputAction.CallbackContext context)
{
// Gameplay 地图停用后,此动作不会再触发。
if (page == Page.Game) Show(Page.Pause);
}
private void OnCancel(NavigationCancelEvent evt)
{
// 防止打开暂停菜单的同一次按键又把它关闭。
if (Time.frameCount == changedFrame) return;
if (page == Page.Pause) Show(Page.Game);
else if (page == Page.SettingsMain) Show(Page.Main);
else if (page == Page.SettingsPause) Show(Page.Pause);
else return;
evt.StopPropagation();
}
private void Show(Page next)
{
page = next;
changedFrame = Time.frameCount;
bool playing = page == Page.Game;
main.style.display = page == Page.Main ? DisplayStyle.Flex : DisplayStyle.None;
pause.style.display = page == Page.Pause ? DisplayStyle.Flex : DisplayStyle.None;
settings.style.display =
page == Page.SettingsMain || page == Page.SettingsPause
? DisplayStyle.Flex : DisplayStyle.None;
Time.timeScale = playing ? 1f : 0f;
playerInput.SwitchCurrentActionMap(playing ? "Gameplay" : "UI");
Cursor.lockState = playing ? CursorLockMode.Locked : CursorLockMode.None;
Cursor.visible = !playing;
if (!playing)
{
Button target = page == Page.Main ? start :
page == Page.Pause ? resume : back;
// 界面切换后的下一次面板更新再设置焦点。
root.schedule.Execute(() => { if (page == next) target.Focus(); });
}
}
private void OnDisable()
{
if (pauseAction != null) pauseAction.performed -= OnPause;
root.UnregisterCallback<NavigationCancelEvent>(OnCancel);
start.clicked -= StartGame;
mainSettings.clicked -= OpenMainSettings;
resume.clicked -= ResumeGame;
pauseSettings.clicked -= OpenPauseSettings;
back.clicked -= Back;
Time.timeScale = 1f;
Cursor.lockState = CursorLockMode.None;
Cursor.visible = true;
}
}预期结果:进入 Play 模式首先看到主菜单;开始后鼠标锁定、角色可移动与攻击;按 Escape 或手柄 Start 显示暂停菜单,角色输入停止;用方向键、手柄十字键或摇杆选中按钮,再按 Enter/手柄南键即可触发 Button.clicked。设置页的“返回”只回到进入设置前的菜单,不改变暂停状态。
验收与常见失效
- 主菜单进入游戏:点击“开始游戏”,检查
Time.timeScale为 1、PlayerInput.currentActionMap.name为Gameplay,确认移动与攻击正常。 - 暂停禁止操作:按 Escape 或手柄 Start,确认时间缩放变为 0、当前地图改为
UI;连续按移动和攻击键,玩家不能再产生新攻击与移动指令。 - 菜单始终可操作:暂停时分别用鼠标单击、键盘方向键加 Enter、手柄方向控制加南键选择“设置”“返回”“继续”。
- 设置返回无误:从主菜单打开设置并返回,应仍停在主菜单;从暂停菜单进入设置并返回,仍保持暂停;再按 Escape/手柄东键可返回游戏。
- 反复切换:连续进行三次暂停、恢复,检查焦点每次落在可见按钮,且不出现一次按键连续开关菜单。
如果菜单能用鼠标却不能用手柄,先查 UI/Navigate、UI/Submit 绑定和 Focus() 的目标是否可见;若暂停期间的界面动画或协程不运行,改用 Time.unscaledDeltaTime 或 WaitForSecondsRealtime。此方案适用于单人、同场景菜单;多人分别操作独立菜单时,应改用每玩家独立的 UI 输入与焦点管理。