本地化服务是负责处理自动翻译的服务。
它用作自动文本替换使用的 LocalizationTable 对象的存储。
本地化服务只会使用其子本地化表格来自动替换文本，除非在 GUI 对象或其祖先上指定 GuiBase2d.RootLocalizationTable 。
概要
属性
用于本地化核心和内部功能的本地 ID。
本地玩家为其操作系统设置的本地ID。
方法
返回用于本地化核心脚本的一列 LocalizationTable 对象列表。
获取用于自动本地化的所有入口。
返回一个 Translator 用于使用加载的本地数据进行翻译。
根据玩家的客户端 IP 地理定位返回国家/地区代码字符串。
直到云端 LocalizationTable 为争论本地已加载 - 如果可用。返回一个 Translator 实例，用于为提供的本地进行翻译。
直到云端 LocalizationTable 为玩家的本地已加载 - 如果可用。返回一个 Translator 实例，用于为提供的本地进行翻译。
属性
SystemLocaleId
此属性显示了本地玩家为其操作系统设置的本地ID。
这将返回带有两个字母代码（例如，“en-us”）的字符串给本地。
还请参阅Player.LocaleId ,用户为其 Roblox 帐户设置的本地 ID，用于本地化体验内容。当 Roblox 尚未内部支持该玩家的本地时，这将是不同的值。
方法
GetTableEntries
返回一个 , 其中每个元素的返回 是与在 中描述的相同格式的输入的自己。返回的元素顺序与 Array 中搜索到的 LocalizationTables 的顺序相同，用于尝试自动本地化提供的 Instance 。特定 LocalizationTable 内的入口元素以未指定的顺序返回。
该函数无论对象是否启用 GuiBase2d 与 GuiBase2d.AutoLocalize ，都返回入口。一个对象，如果不启用 GuiBase2d，将不会自动本地化，除非 GuiBase2d.AutoLocalize 启用。
表的排序如下：
- 首先，它寻找最早的 GuiBase2d 对象（包括提供的对象），该对象具有 GuiBase2d.RootLocalizationTable 。表然后按照在 中描述的顺序插入到那个 的祖先中。如果未找到类似于 GuiBase2d.RootLocalizationTable 的东西，在此步骤中不会添加任何表。如果 instance 是 nil，在此步骤中不添加表。
- 接下来，表从 LocalizationTable 层级下的 LocalizationService 附加。对于每个子 的 , 它添加从服务的父辈表开始上升的表，一路到服务的孩子。如果没有 LocalizationService 的子女是 LocalizationTables ，那么在这一步中没有表附加。
此函数不会产生。它不会等到云 LocalizationTable 加载为止。
参数
返回
一个阵列的阵列，每个阵列的格式与在 LocalizationTable:GetEntries() 中描述的相同。
GetTranslatorForPlayer
此函数将玩家作为参数，返回一个 Translator 实例，可用于执行该本地的翻译，如果可用的话。用于本地化的入口是由 层次提供的入口以及云端的 ，如果可用且已加载。这将是由 LocalizationService:GetTableEntries(nil) 返回的相同集合的输入。
此函数不会产生。它不会等到云 LocalizationTable 加载为止。
还见：
- LocalizationService:GetTranslatorForPlayerAsync() 具有与此函数相同的功能，除了它直到云被加载LocalizationTable后才会返回。
- LocalizationService:GetTranslatorForLocaleAsync() , 返回一个翻译器，用于使用提供的本地进行翻译。
参数
你正在获取的 Player ，用于 Translator 。
返回
指定的本地的 Translator 实例。
代码示例
This code sample attempts to retrieve a Translator object for the local player. LocalizationService:GetTranslatorForPlayerAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, it translates and prints "Hello World!" in the player's language. If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
LocalizationService:GetTranslatorForPlayer() can also be used if you'd like to get the player's translator without yielding until the function returns.
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() , 返回基于地理定位、年龄组和平台的玩家政策信息
参数
你正在获取国家/地区信息的玩家。
返回
表示玩家国家/地区代码的字符串。
代码示例
This code sample gets the country/region code for a local player and prints "Hello, friend from Canada!" if the player's client IP geolocation is Canada.
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 对象，可用于执行该本地的翻译，如果可用的话。用于本地化的入口是由 层次提供的入口，以及云表（如果可用）。这将是由 LocalizationService:GetTableEntries(nil) 返回的相同集合的输入。
此函数可能出错，因此应该被包装在 pcall() 中。
还见：
- LocalizationService:GetTranslatorForPlayer() 获取与提供的玩家本地相对应的翻译器。此函数已过时，不应在新工作中使用。
- LocalizationService:GetTranslatorForPlayerAsync() 直到云端 LocalizationTable 为提供的玩家的本地加载，然后获得与提供的玩家本地相对应的翻译器。
参数
Roblox 支持的语言或本地验证码。
返回
指定的本地的 Translator 实例。
代码示例
This code sample attempts to retrieve a Translator object for the locale "fr" (French).
LocalizationService:GetTranslatorForLocaleAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, prints "Hello in French:" followed by the French translation of "Hello World!". If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
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
此函数将玩家作为参数，直到云 LocalizationTable 为该玩家的本地已加载，如果可用。然后返回一个 Translator 对象，可用于执行该本地的翻译，如果可用的话。用于本地化的入口是由 层次提供的入口，以及云表（如果可用）。这将是由 LocalizationService:GetTableEntries(nil) 返回的相同集合的输入。
此函数可能出错，因此应该被包装在 pcall() 中。
还见：
- LocalizationService:GetTranslatorForPlayer() , 与此函数相同的功能，除了它不会产生并等待直到云端 LocalizationTable 为玩家的本地加载。此函数已被弃用，不应在新工作中使用。
- LocalizationService:GetTranslatorForLocaleAsync() , 返回一个翻译器，用于使用提供的本地进行翻译。
参数
你正在获取的 Player ，用于 Translator 。
返回
指定的本地的 Translator 实例。
代码示例
This code sample attempts to retrieve a Translator object for the local player. LocalizationService:GetTranslatorForPlayerAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, it translates and prints "Hello World!" in the player's language. If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
LocalizationService:GetTranslatorForPlayer() can also be used if you'd like to get the player's translator without yielding until the function returns.
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