UI
自动关联目录:UI
覆盖说明:官方 Creating User Interfaces 大类的子条目无法枚举;UMG 官方文档页抓取为空。本分支按引擎模块组织,具体 API 以目标版本为准。
UE 的 UI 分两层:UMG(给开发者用,蓝图化)与 Slate(引擎底层的 C++ UI 框架,也是编辑器自身用的)。
本目录
| 笔记 | 内容 | 状态 |
|---|---|---|
| UMG 深入 | UWidget 生命周期、绑定、Invalidation | 已补充 |
| Slate 实践 | SWidget、布局、自定义控件 | 已补充 |
| UI 性能 | Invalidation、Volatile、合批、Widget 数量 | 已补充 |
| 输入与焦点 | CommonUI、输入模式、导航 | 已补充 |
| 本地化 | FText、字形缓存、中文项目成本 | 已补充 |
| 3D UI 与 WidgetComponent | 世界空间 UI 的代价与用法 | 已补充 |
阅读顺序与优先级
| 顺序 | 笔记 | 什么时候读 |
|---|---|---|
| 1 | UMG 深入 | 日常开发 |
| 2 | UI 性能 | UI 变卡时 |
| 3 | 输入与焦点 | 多平台/手柄支持 |
| 4 | 本地化 | 出海或中文项目 |
| 5 | Slate 实践 | 编辑器扩展或高性能列表 |
| 6 | 3D UI 与 WidgetComponent | 世界空间 UI |
只有十分钟:UMG 生命周期 + UI 性能里的"不要在 Tick 里刷新"。
排查入口
| 现象 | 先查 |
|---|---|
| UI 卡顿 | UI 性能 |
| 输入穿透/抢焦点 | 输入与焦点 |
| 中文缺字/卡顿 | 本地化 |
| 3D UI 很贵 | 3D UI 与 WidgetComponent |
| 长列表卡 | Slate 实践(ListView 复用) |
层次
Slate(C++ 底层, Immediate Mode 风格,绘制与布局)
↑
UMG(UWidget 封装,蓝图可用,用于游戏内 UI)
↑
你的 HUD / 菜单| UMG | Slate | |
|---|---|---|
| 使用方式 | 蓝图 / C++ | C++ |
| 适用 | 游戏内 UI、菜单 | 编辑器扩展、高性能列表 |
| 性能 | 稍慢(多一层) | 更快 |
| 上手 | 容易 | 较难 |
绝大多数游戏 UI 用 UMG;只有在做编辑器扩展或需要极高性能(大量列表项)时才直接写 Slate。
核心类型
| 类 | 用途 |
|---|---|
UUserWidget | UI 的基本单位 |
UWidgetBlueprint | 可视化编辑的 UI |
AHUD | 旧式 Canvas 绘制(已不推荐) |
UWidgetComponent | 把 UI 贴到世界中的物体上(3D UI) |
UCommonUI(插件) | 多平台输入与导航的通用层 |
常用控件
| 控件 | 用途 |
|---|---|
Canvas Panel | 自由定位 |
Horizontal/Vertical Box | 线性布局 |
Overlay | 层叠 |
Size Box / Scale Box | 尺寸控制 |
Scroll Box / List View | 滚动与列表(ListView 支持复用) |
Rich Text Block | 富文本(图文混排) |
ProgressBar / Image / TextBlock | 基础展示 |
ListView 比 ScrollBox + 大量 Widget 好得多:它复用条目控件,长列表下性能差距巨大。
架构建议
| 模式 | 说明 |
|---|---|
| MVVM 式 | Widget 只做展示,数据从 GameState/PlayerState/ViewModel 取 |
| 事件驱动 | 数据变化 → 委托 → 更新 UI,而不是 Tick 里轮询 |
| 分层 | HUD(常驻)/ 菜单 / 弹窗 分开管理,用栈管理打开关闭 |
| 输入模式 | SetInputMode(GameOnly / UIOnly / GameAndUI) |
不要在 Tick 里更新 UI:用属性变化委托(GetGameplayAttributeValueChangeDelegate、GAS 的属性监听)驱动刷新。
本地化
| 机制 | 说明 |
|---|---|
FText | 本地化的文本类型(UI 上所有文字都用它) |
NSLOCTEXT / LOCTABLE | 定义与查表 |
| 字体与字形缓存 | 中文要注意字形集与缓存大小 |
中文项目的一个实际成本:字形缓存。要预先配置好常用字符集,避免运行时动态生成字形造成卡顿。
性能
| 手段 | 说明 |
|---|---|
Invalidation Box + Is Volatile | 缓存不变的 UI,避免每帧重绘 |
避免大量 Tick 的 Widget | 同上 |
| 减少 Widget 数量 | 用 ListView 复用 |
3D UI 的 WidgetComponent | 每个都是一次渲染,控制数量 |
| 合批 | 同材质同图集更易合批 |
常见坑
| 坑 | 说明 |
|---|---|
| 在 UI 里做游戏逻辑判定 | UI 可能在客户端被绕过,也可能不创建 |
| Tick 里刷新文本 | 每帧重建 Slate 布局,很贵 |
用 FString 显示文本 | 无法本地化,应用 FText |
| 忘记设输入模式 | UI 打开时输入仍穿透到游戏 |
| 长列表用 ScrollBox 堆控件 | 卡顿与内存 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/891542da.html
更新于:2026年11月16日