LocalizationService 是自動翻譯的負荷處理服務。
它是用來存儲 LocalizationTable 對象，用於自動文字替換。
LocalizationService 只會在 GuiBase2d.RootLocalizationTable 被指定為自動文字替換，除非 Class.GuiBase2d.RootLocalizationService 指定了一個 GUI 對象或其上一個對象。
概要
屬性
用於本地化核心和內部功能的語言ID。
本地玩家為其操作系統設定的語言ID。
方法
返回 LocalizationTable 對象，用於本地化核心指令碼。
取得自動本地在地化所使用的所有入口。
返回 Translator 以便使用載入當地資料的語言翻譯。
根據玩家的客戶IP地區來返回國家/地區代碼串。
在雲端上載入 LocalizationTable 為參數語言載入區域 - 如果可用。返回一個 Translator 實例來使用為指定語言提供翻譯。
為玩家的語言區域載入雲端 LocalizationTable 至該玩家的本地 - 如果可用。返回一個 Translator 實例來使用為指定語言區域的翻譯。
屬性
SystemLocaleId
這個屬性顯示本地玩家為操作系統設定的區域 id。
這將返回一個包含兩個字母代碼 (例如 "en-us") 的字串，為該地區。
也參閱 Player.LocaleId ，使用者對 Roblox 帳號設定的本地化語言。這會與 Roblox 內部尚未支援該玩家的語言時的值不同。
方法
GetTableEntries
返回一個 Array ，其中每個元素都是 <code> Class.LocalizationTables</
此功能會無論對象是否為 GuiBase2d 與 GuiBase2d.AutoLocalize 啟用。 一個對象是 GuiBase2d 將不會自動本地化，除非 1> Class.GuiBase2d.AutoLocalize1> 啟用。
桌子的排列如下所示：
- 首先，它尋找最早的 Class.G個體、實例iBase2
- 接下來，從 LocalizationTable 的表階級中的桌子會從最低的兒女表 LocalizationService 開
- 最後，雲端 LocalizationTable app 將結合到陣列。如果沒有雲端 LocalizationTable ，或者雲端 LocalizationTable 尚未載入，則在此步驟中不會有表 app 結合。
此功能不會輸出。它不會等待直到雲端 LocalizationTable 載入。
參數
預設值："nil"
返回
一個用於描述 LocalizationTable:GetEntries() 中所述格式的陣列。
GetTranslatorForPlayer
此功能接受玩家作為參數，並且返回一個 Translator 實例，可以用於執行對該區域進行翻譯，如果可用。 入口用於本地化的是由 Class.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
此功能接受玩家作為參數，並在雲端 LocalizationTable 為該玩家的區域載入時，如果可用，會返回一個 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