使用脚本进行本地化

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LocalizationService = game:GetService("LocalizationService")

-- 本地变量
local localizedImageID
local localizedImage = Instance.new("ImageLabel")

-- 为 "es" 加载翻译器。将函数包裹在 pcall() 中以防止失败。
local res, translator = pcall(function()
	return LocalizationService:GetTranslatorForLocaleAsync("es")
end)

if res then
	-- 通过引用键从本地化表获取资产 ID
	localizedImageID = translator:FormatByKey("Key_JewelsImage")
	-- 设置图像
	localizedImage.Image = "rbxassetid://" .. localizedImageID
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LocalizationService = game:GetService("LocalizationService")

-- 为 "es" 加载翻译器。将函数包裹在 pcall() 中以防止失败。
local res, translator = pcall(function()
	return LocalizationService:GetTranslatorForLocaleAsync("es")
end)

if res then
	-- 使用 Translate 函数，提供对象上下文和字符串
	local sourceTranslation = translator:Translate(game, "Screen")
	print(sourceTranslation) -- 预期输出: "Pantalla"
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LocalizationService = game:GetService("LocalizationService")
local Workspace = game:GetService("Workspace")

-- 为 "es" 加载翻译器。将函数包裹在 pcall() 中以防止失败。
local res, translator = pcall(function()
	return LocalizationService:GetTranslatorForLocaleAsync("es")
end)

if res then
	-- 使用 Translate 函数，提供对象上下文和字符串
	local sourceTranslation = translator:Translate(Workspace.WindowScreen.SurfaceGui.TextLabel, "Screen")
	print(sourceTranslation) -- 预期输出: Mosquitero
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LocalizationService = game:GetService("LocalizationService")

-- 为 "es" 加载翻译器。将函数包裹在 pcall() 中以防止失败。
local res, translator = pcall(function()
	return LocalizationService:GetTranslatorForLocaleAsync("es")
end)

if res then
	-- 将 "Key_Prize_1" 的参数值设置为 100
	local keyTranslation1 = translator:FormatByKey("Key_Prize_1", {100})
	print(keyTranslation1) -- 预期输出: 100 joyas

	-- 将多个参数设置为 500 和 100，通过名称
	local keyTranslation2 = translator:FormatByKey("Key_Prize_2", {AmountCash=500, NumJewels=100})
	print(keyTranslation2) -- 预期输出: $500.00 dinero y 100 joyas
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")

-- 本地变量
local player = Players.LocalPlayer

-- 为 "pt" 加载翻译器。将翻译器函数包装在 pcall() 中以防止失败。
local res1, translator = pcall(function()
	return LocalizationService:GetTranslatorForLocaleAsync("pt")
end)

-- 使用玩家的区域加载第二个翻译器，在此示例中为 "es"
local res2, fallbackTranslator = pcall(function()
	return LocalizationService:GetTranslatorForPlayerAsync(player)
end)

-- 使用第一个翻译器的 Translate 函数
if res1 then
	local translate1 = translator:Translate(game, "jewels")
	print(translate1) -- 在 pt 中的预期输出: joyas
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

-- 使用第二个翻译器的 Translate 函数
if res2 then
	local translate2 = fallbackTranslator:Translate(game, "jewels")
	print(translate2) -- 如果用户设置为 'es': 预期输出: jóias
else
	print('GetTranslatorForPlayerAsync 失败: ' .. fallbackTranslator)
end

local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer

-- 如果 GetTranslatorForPlayerAsync 成功，它将返回玩家当前区域的 Translator
local res, translator = pcall(function()
	return LocalizationService:GetTranslatorForPlayerAsync(player)
end)

-- 当检测到玩家的区域 ID 变化时调用的函数
local function OnLocaleIdChanged()
	print("翻译器已更改为: " .. translator.LocaleId)
	-- 在这里您应该重新翻译使用本地化 API 翻译的任何资产到玩家的新语言
end

-- 检查 GetTranslatorForPlayerAsync 是否成功
if res then
	-- 如果成功，在这里使用翻译器翻译资产
	-- 监听玩家区域 ID 的变化
	translator:GetPropertyChangedSignal("LocaleId"):Connect(OnLocaleIdChanged)
else
	print('GetTranslatorForPlayerAsync 失败: ' .. translator)
end

local TranslationHelper = {}

local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")

-- 本地变量
local player = Players.LocalPlayer
local sourceLanguageCode = "en"

-- 获取翻译器
local playerTranslator, fallbackTranslator
local foundPlayerTranslator = pcall(function()
	playerTranslator = LocalizationService:GetTranslatorForPlayerAsync(player)
end)
local foundFallbackTranslator = pcall(function()
	fallbackTranslator = LocalizationService:GetTranslatorForLocaleAsync(sourceLanguageCode)
end)

-- 创建一个 TranslationHelper.setLanguage 方法，以加载 TranslationHelper 的新翻译
function TranslationHelper.setLanguage(newLanguageCode)
	if sourceLanguageCode ~= newLanguageCode then
		local success, newPlayerTranslator = pcall(function()
			return LocalizationService:GetTranslatorForLocaleAsync(newLanguageCode)
		end)

		-- 仅在新翻译器有效时覆盖当前 playerTranslator（fallbackTranslator 保持为游戏的源语言）
		if success and newPlayerTranslator then
			playerTranslator = newPlayerTranslator
			return true
		end
	end
	return false
end

-- 创建一个 Translate 函数，如果第一个翻译器加载失败或未能成功返回，则使用后备翻译器。您还可以将引用的对象默认为通用对象

function TranslationHelper.translate(text, object)
	if not object then
		object = game
	end
	if foundPlayerTranslator then
		return playerTranslator:Translate(object, text)
	end
	if foundFallbackTranslator then
		return fallbackTranslator:Translate(object, text)
	end
	return false
end

-- 创建一个 FormatByKey() 函数，如果第一个翻译器加载失败或未能成功返回，则使用后备翻译器

function TranslationHelper.translateByKey(key, arguments)
	local translation = ""
	local foundTranslation = false

	-- 首先尝试翻译玩家的语言（如果找到翻译器）
	if foundPlayerTranslator then
		foundTranslation = pcall(function()
			translation = playerTranslator:FormatByKey(key, arguments)
		end)
	end
	if foundFallbackTranslator and not foundTranslation then
		foundTranslation = pcall(function()
			translation = fallbackTranslator:FormatByKey(key, arguments)
		end)
	end
	if foundTranslation then
		return translation
	else
		return false
	end
end

return TranslationHelper

local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- 引用翻译模块
local TranslationHelper = require(ReplicatedStorage:WaitForChild("TranslationHelper"))

-- 使用 TranslationHelper 中提供的函数
TranslationHelper.setLanguage("es")
local sourceTranslation = TranslationHelper.translate("Screen")
print(sourceTranslation) -- 在 'es' 中的预期输出: "Pantalla"