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 的代价与用法已补充

阅读顺序与优先级

顺序笔记什么时候读
1UMG 深入日常开发
2UI 性能UI 变卡时
3输入与焦点多平台/手柄支持
4本地化出海或中文项目
5Slate 实践编辑器扩展或高性能列表
63D UI 与 WidgetComponent世界空间 UI

只有十分钟:UMG 生命周期 + UI 性能里的"不要在 Tick 里刷新"。

排查入口

现象先查
UI 卡顿UI 性能
输入穿透/抢焦点输入与焦点
中文缺字/卡顿本地化
3D UI 很贵3D UI 与 WidgetComponent
长列表卡Slate 实践(ListView 复用)

层次

Slate(C++ 底层, Immediate Mode 风格,绘制与布局)
   ↑
UMG(UWidget 封装,蓝图可用,用于游戏内 UI)
   ↑
你的 HUD / 菜单
UMGSlate
使用方式蓝图 / C++C++
适用游戏内 UI、菜单编辑器扩展、高性能列表
性能稍慢(多一层)更快
上手容易较难

绝大多数游戏 UI 用 UMG;只有在做编辑器扩展或需要极高性能(大量列表项)时才直接写 Slate。

核心类型

类用途
UUserWidgetUI 的基本单位
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 堆控件卡顿与内存