61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
|
---
|
|||
|
|
title: UMG本地化
|
|||
|
|
date: 2026-05-03 00:00:00
|
|||
|
|
excerpt: 平台感知的多语言文本系统（平台后缀、语言 ID）
|
|||
|
|
tags:
|
|||
|
|
- ARC
|
|||
|
|
- UI
|
|||
|
|
- UMG
|
|||
|
|
- Localization
|
|||
|
|
rating: ⭐
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# UMG 本地化
|
|||
|
|
|
|||
|
|
返回 [[UI]]
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
ARC 引擎为 UMG 文本系统添加了平台感知的本地化机制，允许同一文本 ID 在不同平台上显示不同内容（例如按钮提示文本因平台不同而变化）。
|
|||
|
|
|
|||
|
|
## 平台后缀系统
|
|||
|
|
|
|||
|
|
文本 ID 查找时自动追加平台后缀：
|
|||
|
|
|
|||
|
|
| 平台 | 后缀 |
|
|||
|
|
|------|------|
|
|||
|
|
| PS5 | `_PS5` |
|
|||
|
|
| Xbox Series X | `_XSX` |
|
|||
|
|
| 其他 | 无后缀（使用默认文本） |
|
|||
|
|
|
|||
|
|
查找顺序：
|
|||
|
|
1. 先查 `TextID_PS5`（或 `_XSX`）
|
|||
|
|
2. 找不到则回退到 `TextID`
|
|||
|
|
|
|||
|
|
## 语言 ID
|
|||
|
|
|
|||
|
|
新增 CVar `sg_REDLanguageID`，允许运行时切换语言而不依赖系统语言设置：
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
static TAutoConsoleVariable<int32> CVarREDLanguageID(
|
|||
|
|
TEXT("sg.REDLanguageID"),
|
|||
|
|
0,
|
|||
|
|
TEXT("Override language ID for RED localization"));
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 自定义 L10N 加载
|
|||
|
|
|
|||
|
|
`Source/Runtime/Core/` 中的本地化文件加载逻辑支持自定义 L10N 目录。
|
|||
|
|
|
|||
|
|
## 兼容性
|
|||
|
|
|
|||
|
|
`UOldRichTextBlockDecorator` 兼容层确保旧版富文本格式在新系统中正常工作。
|
|||
|
|
|
|||
|
|
## 修改文件列表
|
|||
|
|
|
|||
|
|
涉及 `Source/Runtime/UMG/` 下约 12 个文件，主要覆盖：
|
|||
|
|
- `TextBlock` 相关 — 平台后缀查找
|
|||
|
|
- `TextWidgetTypes` — 垂直对齐（与 [[Slate扩展]] 配合）
|
|||
|
|
- `RichTextBlockDecorator` — 兼容层
|
|||
|
|
- `WidgetComponent` — 修改
|