跳转到正文

UI系统

通用游戏系统的UI系统部分,是基于虚幻引擎的CommonUI插件构建,并扩充了其相关功能。 它的主要目标是:提供用户所需的基础系统,以一种清晰,合理的方式去构建简单到复杂的UI。 而这部分的文档将阐述使用该系统所需的基本知识。

作

作者

作者

创建时间: 2025年4月14日更新时间: 2026年10月19日

目录

系统职责

GenericUISystem 建立在 Unreal Engine 的 CommonUI 之上,提供布局、激活式界面、异步 UI Action、移动输入控件和面向 Gameplay Feature 的扩展入口。它提供 UI 组合基础设施,不替项目决定视觉风格、具体页面内容或输入策略。

配套项目中的 UI 资产

当前 GenericGame 项目的 UICore 包含 GUI_GameUIPolicy、WB_GUI_GameUILayout、BP_GUI_HUD、WB_GUI_HUD_Generic 和通用暂停菜单;UIExtras 中还有 Theme_Default。可选设置 UI 模块也有对应的设置菜单与 Panel Widget。它们提供了检查布局、Policy、HUD、菜单和主题如何组合的项目示例,但并不改变插件本体不含 UI Content 的发行边界。完整路径见配套项目内容与示例资产。

推荐阅读顺序

  • UI 布局/层系统:理解根布局和 UI Layer。
  • UI 拓展系统:让 Gameplay Feature 注册或移除 UI 内容。
  • UI 上下文系统:按上下文组织和切换 UI。
  • UI Action 系统:使用异步动作驱动 UI 流程。
  • UI 组件参考:查阅插件提供的组件和扩展点。

设置菜单使用单独的可选适配模块,可继续阅读 设置菜单 UI 接入。

前置知识

需要具备 Unreal Engine UMG 和 CommonUI 的基本经验。可先查看 Unreal Engine CommonUI 官方概览;也可观看 Introduction to Common UI | Inside Unreal。