游戏引擎 / 系统课时

切换主菜单暂停菜单与输入焦点

切换主菜单暂停菜单与输入焦点

把主菜单、暂停菜单和设置页接到同一套游戏状态:进入暂停后,场景停止按游戏时间推进,移动与攻击输入失效,但鼠标、键盘和手柄仍能操作菜单;关闭菜单时恢复原来的输入与焦点。

学习目标

  • 用明确状态控制菜单可见性、Time.timeScale 和鼠标锁定。
  • 在 Gameplay 与 UI Action Map 之间切换,避免暂停后仍能攻击。
  • 让设置页正确返回来源菜单,并为手柄指定初始焦点。

准备界面与输入资产

以下步骤适用于 Unity 6(6000.0 及之后)和新版 Input System,界面使用运行时 UI Toolkit,不混用 uGUI。

  1. 在 Window > Package Manager 安装 Input System;到 Edit > Project Settings > Player > Other Settings > Configuration,将 Active Input Handling 设为 Input System Package (New)。
  2. 在 Edit > Project Settings > Input System Package 创建或指定项目级 Input Actions 资产。保留 UI 地图及其 Navigate、Submit、Cancel、Point、Click 等默认动作和类型,确保方向键/手柄摇杆可导航、Enter/手柄南键可确认。
  3. 在同一资产新增 Gameplay 地图,保留角色已有的 Move 和 Attack,添加 Pause(类型 Button),绑定 <Keyboard>/escape 和 <Gamepad>/start;给 UI/Cancel 绑定 Escape、手柄东键,并可增加手柄 Start。
  4. 将此资产赋给角色的 PlayerInput > Actions,Default Map 设为 Gameplay。角色移动和战斗脚本须读取 PlayerInput 管理的动作,不能另行从始终启用的项目级 Gameplay 动作直接驱动角色。
  5. 用 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 的取消键。

csharp
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。设置页的“返回”只回到进入设置前的菜单,不改变暂停状态。

验收与常见失效

  1. 主菜单进入游戏:点击“开始游戏”,检查 Time.timeScale 为 1、PlayerInput.currentActionMap.name 为 Gameplay,确认移动与攻击正常。
  2. 暂停禁止操作:按 Escape 或手柄 Start,确认时间缩放变为 0、当前地图改为 UI;连续按移动和攻击键,玩家不能再产生新攻击与移动指令。
  3. 菜单始终可操作:暂停时分别用鼠标单击、键盘方向键加 Enter、手柄方向控制加南键选择“设置”“返回”“继续”。
  4. 设置返回无误:从主菜单打开设置并返回,应仍停在主菜单;从暂停菜单进入设置并返回,仍保持暂停;再按 Escape/手柄东键可返回游戏。
  5. 反复切换:连续进行三次暂停、恢复,检查焦点每次落在可见按钮,且不出现一次按键连续开关菜单。

如果菜单能用鼠标却不能用手柄,先查 UI/Navigate、UI/Submit 绑定和 Focus() 的目标是否可见;若暂停期间的界面动画或协程不运行,改用 Time.unscaledDeltaTime 或 WaitForSecondsRealtime。此方案适用于单人、同场景菜单;多人分别操作独立菜单时,应改用每玩家独立的 UI 输入与焦点管理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

切换主菜单暂停菜单与输入焦点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通