游戏引擎 / 系统课时
组织 Canvas 与 HUD 层级
组织 Canvas 与 HUD 层级
生命值 HUD、背包页面和确认弹窗如果混放在一个 Canvas 中,常会出现弹窗被遮住、按钮点穿到下层,或关闭面板后交互失效。本课建立三层 uGUI 结构,分别管理常驻信息、功能页面和模态弹窗,并让渲染顺序与输入拦截相互配合。
学习目标
- 区分 HUD、功能页面与模态弹窗的显示职责。
- 使用 Canvas 排序、GraphicRaycaster 和 CanvasGroup 管理层级与点击。
- 实现弹窗开启、关闭及底层交互恢复,并验证输入优先级。
把常驻信息、页面和弹窗分开
HUD 放血条、准星、任务提示等常驻信息;页面放背包、地图、角色面板等可切换内容;模态弹窗放二次确认、退出提示等必须先回应的内容。三者变化频率、遮挡要求不同,分开管理能减少误操作,也更便于定位问题。
这里采用三个同级的 Screen Space - Overlay Canvas,排序值由低到高分别为 0、10、20。弹窗不仅要画在最上层,还要阻止下层 UI 响应。更高的 sortingOrder 负责显示顺序,是否接收点击仍需由图形射线和交互状态决定。

在场景中建立可控层级
- 创建空的
UIRoot。在它下面建立三个同级 Canvas:HUDCanvas、PageCanvas、ModalCanvas,均采用Screen Space - Overlay,并处于同一个排序层。每层保留GraphicRaycaster,根据分辨率需求给各层配置CanvasScaler。 - 在
HUDCanvas放血条、准星和“打开弹窗”按钮,在PageCanvas放页面内容。在ModalCanvas下建立ModalRoot,其内先放铺满屏幕的半透明Image(Backdrop),再放弹窗面板和“关闭”按钮。 - 为
HUDCanvas、PageCanvas、ModalRoot各添加一个CanvasGroup。确认Backdrop的Raycast Target开启,并关闭纯装饰性文字、图标不必要的Raycast Target,避免挡住实际按钮。 - 场景只保留一个
EventSystem,配备与项目输入方案对应的 UI Input Module。它调度 UI 事件,不能用增加多个 EventSystem 的方式提高弹窗优先级。
让弹窗切换同时控制点击
建立 UiLayerController.cs,挂在 UIRoot 上。把三个 Canvas、三个 CanvasGroup 和 ModalRoot 依次拖入 Inspector 对应字段。此示例的功能页面默认存在;具体是否显示背包内容,可由页面自身另行控制。
using UnityEngine;
public class UiLayerController : MonoBehaviour
{
[SerializeField] private Canvas hudCanvas;
[SerializeField] private Canvas pageCanvas;
[SerializeField] private Canvas modalCanvas;
[SerializeField] private CanvasGroup hudGroup;
[SerializeField] private CanvasGroup pageGroup;
[SerializeField] private CanvasGroup modalGroup;
[SerializeField] private GameObject modalRoot;
private void Awake()
{
hudCanvas.sortingOrder = 0;
pageCanvas.sortingOrder = 10;
modalCanvas.sortingOrder = 20;
SetModalOpen(false);
}
public void OpenModal() => SetModalOpen(true);
public void CloseModal() => SetModalOpen(false);
private void SetModalOpen(bool opened)
{
// 模态弹窗显示时,底层 UI 不参与图形射线命中。
hudGroup.interactable = !opened;
hudGroup.blocksRaycasts = !opened;
pageGroup.interactable = !opened;
pageGroup.blocksRaycasts = !opened;
modalRoot.SetActive(opened);
modalGroup.interactable = opened;
modalGroup.blocksRaycasts = opened;
Debug.Log(opened ? "Modal open" : "Modal closed");
}
}预期输出:进入 Play 模式时 Awake 先关闭弹窗;随后依次按下打开、关闭按钮,Console 应显示:
Modal closed
Modal open
Modal closed在两个按钮的 On Click() 事件中分别绑定 UIRoot 上的 OpenModal 与 CloseModal。CanvasGroup.blocksRaycasts = false 表示这组图形不参与 UI 射线命中,绝不是“替下层挡住点击”;真正的全屏遮挡来自上层 Backdrop,而脚本又显式禁用了下层交互,形成双重保护。具体规则可对照 Unity CanvasGroup API。
用可见行为验收层级和输入
进入 Play 模式,先检查 HUD 正常显示且按钮可点击;点击打开按钮后,弹窗应位于背包与 HUD 之上,弹窗外的背景区域不能触发下层按钮。关闭弹窗后,底层按钮应恢复可用,不需要重新启用整个 Canvas。
如果弹窗显示但无法点击,先检查场景是否存在活动的 EventSystem、ModalCanvas 的 GraphicRaycaster、弹窗按钮的 Interactable,以及是否有其他透明图形盖在按钮上。如果点击穿透,检查遮罩是否真正铺满屏幕且启用了 Raycast Target,不要只调整排序值。
这套分层的关键是把显示顺序、UI 点击拦截和游戏操作权限作为三个独立问题处理:Canvas 管绘制,GraphicRaycaster 与 CanvasGroup 管 UI 命中,玩法输入系统管角色是否继续响应操作。