游戏引擎 / 系统课时

处理按钮与游戏输入冲突

处理按钮与游戏输入冲突

本课解决打开菜单后角色仍移动、点击 UI 按钮时同时触发攻击的问题。我们将用菜单状态阻断玩法输入,并使用 UI 射线检测区分鼠标点击的目标,让键盘移动、鼠标攻击和界面按钮各自进入正确的处理路径。

学习目标

  • 区分 UI 事件处理与角色玩法输入,理解输入冲突的根因。
  • 在菜单开启时阻断移动和攻击,同时保留 UI 按钮交互。
  • 使用 GraphicRaycaster 检测鼠标是否命中 UI,并验证打开、关闭菜单时不会误触发攻击。

明确输入由谁消费

一个常见实现是角色脚本每帧读取键盘和鼠标,按钮则由 Unity 的 EventSystem 负责响应。问题在于这两套处理逻辑默认不是互斥的:鼠标点击 UI 时,角色脚本仍可能看到鼠标按下;菜单打开后,键盘移动轴也可能继续返回非零值。

因此不能只依靠 UI 按钮本身阻止角色操作。输入消费至少需要两条规则:

  • 菜单状态优先:菜单开启期间,Gameplay 不处理移动与攻击,但 UI 继续接收按钮事件。
  • 指针命中 UI 优先:菜单关闭时,鼠标点击如果落在可接收射线的 UI 元素上,就不当作场景攻击。

UI与Gameplay输入分流及菜单阻断关系

EventSystem 管理 UI 的指针、选择和提交事件,GraphicRaycaster 检测 Canvas 内能够响应图形射线的元素。但它们不会自动停止另一个角色脚本调用 Input.GetAxisRaw 或 Input.GetMouseButtonDown。阻断玩法操作仍是游戏输入层的责任。

准备可交互的测试场景

下面采用 uGUI 与旧版 Input Manager 编写一个可运行的最小案例,适用于启用了 Input Manager (Old) 或 Both 的 Unity 项目。使用新 Input System 独占模式的项目,需要先切换输入配置才能直接运行这份示例。

  1. 打开 Edit > Project Settings > Player,在 Other Settings > Configuration 中确认 Active Input Handling 包含旧版 Input Manager。并检查 Edit > Project Settings > Input Manager 中存在默认的 Horizontal 与 Vertical 输入轴。
  2. 创建一个 Cube,命名为 Player,放在摄像机可以看到的位置。之后将角色输入脚本挂到它上面。
  3. 创建 Canvas,确认它带有 GraphicRaycaster,并确保场景内有一个正常工作的 EventSystem。使用旧版 UI 输入方案时可配合 Standalone Input Module。
  4. 在 Canvas 中创建一个 OpenMenuButton,按钮文字设为 打开菜单。再创建 MenuPanel,内部放置一个 CloseMenuButton,按钮文字设为 继续游戏。
  5. 创建始终保持激活的空对象 UIRoot,用于放置菜单控制脚本。不要把菜单控制脚本挂在准备关闭的 MenuPanel 上,否则面板禁用后就不能继续在该脚本中检测 Escape 按键。

本例让所有需要拦截鼠标点击的 UI 位于同一个 Canvas 下。多个 Canvas 的项目需要分别考虑各自的图形射线检测范围。

使用菜单状态统一关闭玩法输入

在 Assets/Scripts 创建 PauseMenuController.cs,将其挂到 UIRoot,并把 MenuPanel 拖入对应字段。

csharp
using UnityEngine;

public sealed class PauseMenuController : MonoBehaviour
{
    [SerializeField] private GameObject menuPanel;

    public bool IsOpen { get; private set; }
    private int changedFrame = -1;

    // 供玩法脚本识别菜单切换发生的那一帧。
    public bool ChangedThisFrame => changedFrame == Time.frameCount;

    private void Awake()
    {
        IsOpen = false;
        menuPanel.SetActive(false);
    }

    private void Update()
    {
        if (Input.GetKeyDown(KeyCode.Escape))
            SetOpen(!IsOpen);
    }

    public void OpenMenu() => SetOpen(true);
    public void CloseMenu() => SetOpen(false);

    private void SetOpen(bool open)
    {
        // 相同状态不重复切换,也不重复记录变化帧。
        if (IsOpen == open) return;

        IsOpen = open;
        changedFrame = Time.frameCount;
        menuPanel.SetActive(open);
    }
}

这是完整主示例的菜单控制部分,需要配合下一节的角色输入脚本运行。

在 OpenMenuButton 的 On Click() 中绑定 UIRoot 上的 PauseMenuController.OpenMenu();在 CloseMenuButton 的 On Click() 中绑定 CloseMenu()。它们均为无参数的公开方法,可以直接由 Button 调用。

菜单状态使用 IsOpen 作为唯一判断依据,而不是让每个角色行为脚本分别检查不同 UI 对象是否显示。ChangedThisFrame 额外记录状态发生变化的帧,便于阻止切换瞬间残留的玩法输入。

需要注意,以上实现只是关闭角色输入,没有调用 Time.timeScale,因此并不会自动暂停物理模拟、动画或其他游戏系统。这一节的验收目标是输入互斥,而不是完整的游戏暂停系统。

避免点击按钮时同时攻击

接下来创建 DemoPlayerInput.cs 并挂到 Player。它负责两个行为:WASD 沿 XZ 平面移动,以及鼠标左键触发一次示例攻击日志。

与只检查 IsPointerOverGameObject() 不同,这里在发生鼠标按下时,主动用 GraphicRaycaster.Raycast 对当前鼠标坐标做一次 UI 命中检测。这样不必依赖 EventSystem 在这一帧是否已经刷新指针悬停状态。

csharp
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.UI;

public sealed class DemoPlayerInput : MonoBehaviour
{
    [SerializeField] private PauseMenuController menu;
    [SerializeField] private GraphicRaycaster uiRaycaster;
    [SerializeField, Min(0f)] private float moveSpeed = 4f;

    private void Update()
    {
        // 菜单开启或切换的当帧,不消费任何玩法输入。
        if (menu.IsOpen || menu.ChangedThisFrame ||
            Input.GetKeyDown(KeyCode.Escape))
            return;

        float x = Input.GetAxisRaw("Horizontal");
        float z = Input.GetAxisRaw("Vertical");
        Vector3 direction = new Vector3(x, 0f, z);
        direction = Vector3.ClampMagnitude(direction, 1f);

        transform.Translate(
            direction * moveSpeed * Time.deltaTime,
            Space.World
        );

        // 鼠标命中 UI 时不能同时视为游戏内攻击。
        if (Input.GetMouseButtonDown(0) && !MouseHitsUi())
            Debug.Log("Attack");
    }

    private bool MouseHitsUi()
    {
        if (EventSystem.current == null || uiRaycaster == null)
            return false;

        var pointer = new PointerEventData(EventSystem.current)
        {
            position = Input.mousePosition
        };

        var hits = new List<RaycastResult>();
        uiRaycaster.Raycast(pointer, hits);
        return hits.Count > 0;
    }
}

在 Inspector 中,将 UIRoot 上的菜单控制组件拖入 Menu 字段,将 Canvas 上的 GraphicRaycaster 拖入 Ui Raycaster 字段。确认 Player 在 Game 视图中可见,再进入 Play 模式。

预期结果:

  • 菜单关闭时,按 WASD,Player 会沿世界 XZ 平面移动。
  • 菜单关闭时,鼠标点击没有 UI 遮挡的 Game 视图区域,会执行一次示例攻击。
  • 鼠标点击 打开菜单,面板正常打开,但不会同时触发攻击。
  • 菜单开启后,按 WASD 或点击场景空白区域,Player 不移动,也不会执行攻击。
  • 按 Escape 或点击 继续游戏 后,面板关闭,玩法输入恢复。Escape 切换帧不会执行玩法输入。

点击没有 UI 遮挡的区域时,Unity Console 预期输出:

text
Attack

每次有效鼠标按下会输出一条 Attack。点击 UI 按钮不应产生这条日志。transform.Translate 是为了演示输入路由而使用的简单移动方式;采用 Rigidbody、CharacterController 或其他角色运动方案时,应保留相同的输入门控规则,但使用对应的运动接口。

验收与常见冲突

输入冲突不只发生在按下按钮的一刻,还可能出现在菜单开启、关闭和切换控制设备的边界。建议按以下顺序验证。

  1. 在菜单关闭时按住 W,观察角色持续移动;保持 W 不松开并点击 打开菜单,角色应停止移动。
  2. 在菜单开启时点击 继续游戏,确认界面关闭后可以重新移动,并且关闭操作不会额外输出 Attack。
  3. 在菜单关闭时反复点击打开按钮,确认点击 UI 不会触发攻击。随后点击没有 UI 覆盖的区域,确认攻击能够正常触发。
  4. 使用 Escape 反复打开和关闭菜单,检查角色不会因为该按键的同帧处理顺序而误执行移动或攻击。

如果点击某个 UI 区域仍然触发攻击,应先检查 Canvas 是否启用了 GraphicRaycaster,以及需要拦截点击的 Button 或 Image 是否允许 Raycast Target。如果鼠标在整个游戏画面上都无法攻击,则需要检查是否有覆盖全屏、启用了 Raycast Target 的透明 Image 阻挡了射线。

本示例只处理键盘与鼠标。对于触屏,必须结合实际触点与 UI 命中进行判断,不能把所有触摸都当作鼠标左键;对于新 Input System,可以将 UI 与 Gameplay 组织到不同 Action Map,并在打开菜单时禁用 Gameplay Action Map、保持 UI Action Map 可用。无论选用哪一种输入 API,核心原则都是一致的:先确定当前输入属于谁,再决定是否执行玩法操作。

当游戏中的背包、设置、对话框和暂停面板逐渐增多时,可以进一步把 IsOpen 扩展成统一的输入上下文或界面栈,集中管理优先级,避免在每一种攻击、移动和交互代码里重复编写菜单判断。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理按钮与游戏输入冲突

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

登录哪都通