LocalizationService 是自动翻译的服务。
它用作自动文本替换的存储。
LocalizationService 只会使用子级 LocalizationTables 自动替换文本，除非 GuiBase2d.RootLocalizationTable 指定在 GUI 对象或其父辈上。
概要
属性
用于本地化核心和内部功能的本地化ID。
本地玩家为其操作系统设置的本地地区 id。
方法
返回用于本地化核心脚本的 LocalizationTable 对象列表。
获取用于自动本地化的所有入口。
返回一个 Translator 用于使用本地数据加载的翻译。
根据玩家的客户端 IP 地理位置返回国家/区域代码串。
云端 LocalizationTable 为参数本地化表已加载 - 如果可用。返回一个 Translator 实例来使用为提供的语言进行本地化。
云端 LocalizationTable 为玩家的本地语言已加载 - 如果可用。返回一个 Translator 实例来为提供的语言进行翻译。
属性
SystemLocaleId
这个属性显示本地玩家为其操作系统设置的本地语言ID。
这将返回一个包含两个字母代码（例如“en-us”）的字符串，为地区。
还请参阅Player.LocaleId，用户为其 Roblox 帐户设置的本地化内容。当 Roblox 还不支持该玩家的本地语言时，这将是一个不同的值。
方法
GetTableEntries
返回一个 Array ，其中每个元素都是自己一个 Array
此函数将返回入口，无论对象是否启用了 GuiBase2d。一个 GuiBase2d.AutoLocalize 的对象，即使未启用 GuiBase2d，也不会自动本地化。
桌子的排序如下所示：
- 首先，它在最早的 GuiBase2d
- 然后，在 LocalizationTable 的附后，表从 LocalizationService 的表的父级，一直升级到服务的子孩子。如果
- 最后，云端 LocalizationTable 应用程序附加到阵数组。如果没有云端 LocalizationTable 或云端 LocalizationTable 尚未加载，那么在此步骤中不会有表 appends。
此函数不会生成。它不会等待直到云端 LocalizationTable 已加载。
参数
默认值："nil"
返回
一个阵列，其中每个阵列都按描述在 LocalizationTable:GetEntries() 中的格式进行描述。
GetTranslatorForPlayer
此函数接受一个玩家作为参数，并返回一个 Translator 实例，可以用于为该地区执行翻译，如果可用。 入口用于本地化的是由 LocalizationTable 下的
此函数不会生成。它不会等待直到云端 LocalizationTable 已加载。
还请参阅：
- LocalizationService:GetTranslatorForPlayerAsync() 具有与此功能相同的功能，除了它在云上 LocalizationTable 已加载之前产生。
- LocalizationService:GetTranslatorForLocaleAsync()，返回一个 Translator 用于使用指定语言的本地化。
参数
您正在使用 Class.Player 获得 Class.Translator。
返回
指定当前地区的 Translator 实例。
代码示例
Getting and Using a Translator for a Player
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForPlayerAsync(Players.LocalPlayer)
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print(result)
else
print("GetTranslatorForPlayerAsync failed: " .. translator)
endGetCountryRegionForPlayerAsync
根据玩家的客户端 IP 地理位置返回一个国家/区域代码串。支持的国家/区域代码如下：
| 代码 | 国家/地区 |
|---|
| 代码 | 国家/地区 |
|---|
| 代码 | 国家/地区 |
|---|
还请参阅：
- PolicyService:GetPolicyInfoForPlayerAsync()，返回基于地点、年龄组和平台的玩家的政策信息
参数
您获取国家/地区信息的玩家。
返回
指示玩家国家/地区代码的字符串。
代码示例
Getting Country/Region Code for a Player
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local result, code = pcall(LocalizationService.GetCountryRegionForPlayerAsync, LocalizationService, player)
if result and code == "CA" then
print("Hello, friend from Canada!")
else
print("GetCountryRegionForPlayerAsync failed: " .. code)
endGetTranslatorForLocaleAsync
此函数使用本地代码作为参数，并且在云端 LocalizationTable 为该本地有效，如果可用。它将返回一个 Translator 对象，可以用于
此函数可能会发生错误，因此应该包含在 pcall() 中。
还请参阅：
- LocalizationService:GetTranslatorForPlayer() 获取与指定玩家所在位置相对应的翻译机。此功能已过期，不应在新工作中使用。
- LocalizationService:GetTranslatorForPlayerAsync() 会生成直到云端 LocalizationTable 为指定玩家的本地化为准，然后获取与指定玩家的本地化相对应的语言。
参数
Roblox 支持的语言或地区验证码。
返回
指定当前地区的 Translator 实例。
代码示例
Getting and Using a Translator for a Locale
local LocalizationService = game:GetService("LocalizationService")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForLocaleAsync("fr")
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print("Hello in French: " .. result)
else
print("GetTranslatorForLocaleAsync failed: " .. translator)
endGetTranslatorForPlayerAsync
此函数接受一个玩家作为参数，并且在云端上加载该玩家的本地语言，如果可用。它然后返回一个 Translator 对象，可以用于为该语
此函数可能会发生错误，因此应该包含在 pcall() 中。
还请参阅：
- LocalizationService:GetTranslatorForPlayer() , 与此功能相同，除了它不会生成并且不会等待直到云端 LocalizationTable 为玩家的本地语言已加载。此函数已过期，不应在新工作中使用。
- LocalizationService:GetTranslatorForLocaleAsync()，返回一个 Translator 用于使用指定语言的本地化。
参数
您正在使用 Class.Player 获得 Class.Translator。
返回
指定当前地区的 Translator 实例。
代码示例
Getting and Using a Translator for a Player
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForPlayerAsync(Players.LocalPlayer)
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print(result)
else
print("GetTranslatorForPlayerAsync failed: " .. translator)
end