BlueRoseNote/03-UnrealEngine/卡通渲染相关资料/渲染功能/ARC/UI/UMG本地化.md

title, date, excerpt, tags, rating

title	date	excerpt	tags	rating
UMG本地化	2026-05-03 00:00:00	平台感知的多语言文本系统（平台后缀、语言 ID）	ARC UI UMG Localization	⭐

UMG 本地化

返回 UI

概述

ARC 引擎为 UMG 文本系统添加了平台感知的本地化机制，允许同一文本 ID 在不同平台上显示不同内容（例如按钮提示文本因平台不同而变化）。

平台后缀系统

文本 ID 查找时自动追加平台后缀：

平台	后缀
PS5	_PS5
Xbox Series X	_XSX
其他	无后缀（使用默认文本）

查找顺序：

1. 先查 TextID_PS5（或 _XSX）
2. 找不到则回退到 TextID

语言 ID

新增 CVar sg_REDLanguageID，允许运行时切换语言而不依赖系统语言设置：

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 — 修改