SuperAPI AI 工具集

roblox-localization

通用与其它

查看项目

更新于 10-16 09:41

技能介绍

用途

该技能在实现多语言支持、翻译系统、区域特定内容或地区检测时加载。内容覆盖 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。