用途
该技能在实现多语言支持、翻译系统、区域特定内容或地区检测时加载。内容覆盖 LocalizationService、LocalizationTable、自动翻译以及国家/地区检测。
区域设置检测
- player.LocaleId:玩家为其 Roblox 账户设置的区域设置(例如 en-us、pt-br、ja-jp)。
- LocalizationService.RobloxLocaleId:核心/内部功能使用的区域设置。
- LocalizationService.SystemLocaleId:玩家操作系统的区域设置。
- LocalizationService:GetCountryRegionForPlayerAsync(player):通过 IP 地理定位返回国家代码(例如 US、BR、JP)。
翻译表
- LocalizationTable:存储翻译条目(键 → 各区域设置的翻译)。
- 将 LocalizationTable 的父级设为 LocalizationService 以启用自动翻译。
- 在 GUI 对象上设置 GuiBase2d.RootLocalizationTable 以使用逐元素表。
- Studio 可通过 Localization Tools 插件自动将字符串提取到表中。
自动翻译
- 自动翻译要求 GUI 及其祖先上的 AutoLocalize = true,并存在匹配的表条目。
- 正常设置 TextLabel.Text;引擎会为玩家的区域设置将其替换为翻译后的字符串。
- 缺少翻译时回退到源文本。
手动翻译
local translator = LocalizationService:GetTranslatorForPlayerAsync(player) local translated = translator:Translate(game, "Welcome!") local formatted = translator:FormatByKey("coins_count", {count})
国家/地区检测
local country = LocalizationService:GetCountryRegionForPlayerAsync(player) if country == "US" then -- USD pricing -- US offer elseif country == "GB" then -- UK offer end
关键规则
- GetCountryRegionForPlayerAsync 是异步的;应包裹在 pcall 中,可能失败。
- GetTranslatorForPlayerAsync 是异步的;应缓存 translator。
- 设置 RootLocalizationTable 以选择表;在祖先链上保持 AutoLocalize 为 true。
- 翻译条目:SourceText、SourceLocaleId,然后是 en-us、pt-br 等列。
- 可在 Studio 中将表导出/导入为 CSV 以进行批量编辑。
- 使用 Studio 的区域设置模拟器测试不同区域设置。
陷阱
- 并非所有区域设置都受支持;检查 player.LocaleId。
- 自动翻译不适用于非 GUI 文本;请使用手动 Translator:Translate。
- GetCountryRegionForPlayerAsync 使用 IP 地理定位,因此 VPN 会给出错误结果。
- 缺少条目时会静默回退到源文本。
需要更多细节?加载 references/full.md。