本地化服務是負責處理自動翻譯的服務。
它用於自動文字替換使用的 LocalizationTable 對象的儲存。
本地化服務只會使用其子本地化表格來自動替換文字，除非在 GUI 對象或其祖先上指定 GuiBase2d.RootLocalizationTable 。
概要
屬性
用於本地化核心和內部功能的本地 ID。
本地玩家為其操作系統設置的本地ID。
方法
返回一個列表的 LocalizationTable 對象，用於本地化核心腳本。
獲得所有用於自動本在地化的入口。
返回 Translator 用於使用載入的本地資料進行翻譯。
根據玩家的客戶端 IP 地理定位返回國家/地區代碼字串。
直到雲端 LocalizationTable 為論據本地載入了 - 如果可用。返回一個 Translator 實例，用於提供的本地進行翻譯。
直到雲端 LocalizationTable 為玩家的本地載入 - 如果可用。返回一個 Translator 實例，用於提供的本地進行翻譯。
屬性
SystemLocaleId
此屬性顯示本地玩家為其操作系統設置的本地ID。
這將返回帶有兩個字母代碼的字串 (例如, "en-us") 給本地。
請參閱Player.LocaleId，用戶為其 Roblox 帳戶設置的本地 ID，用於本地化體驗內容。當 Roblox 尚未內部支持該玩家的本地時，這將是不同的值。
方法
GetTableEntries
返回 Array ，其中每個返回的 Array 元素都是與在 LocalizationTable:GetEntries() 中描述的格式相同的 Array 的入口。返回的元素順序與 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