本地化表是翻译的数据库。它包含各种语言的源字符串和翻译。它与 Translator 和 LocalizationService 自动翻译系统一起用于控制游戏中的文本翻译。本地化表被设计为像纹理或脚本一样被处理的资源。它们在运行时不优化以进行修改。更改表的内容会导致整个表的内容复制到所有玩家。
本地化表入口
每个本地化表包含一组入口。每个入口包含文本的翻译，以及一些特殊字段：
- 键 是代验证码快速查找的唯一键。如果它不为空，它必须在表中独一无二。
- 来源 是源语言中的原始文本，将被 LocalizationService 自动文本替换系统用于匹配 GUI 文本并渲染翻译。来源字段可以由文本捕捉工具填充，或可以手动设置。对于基于键的查找，源值可以用作该地区的翻译，如果入口没有该地区的翻译。如果源为空，则入口不会被自动替换系统使用。
- 上下文 是文本出现在对象上的全名称。上下文被自动文本替换系统用于解释。当源的多个匹配项被找到时，系统会从上下文字符串的最后匹配倒回，选择最佳匹配项。还有其他更强大的方法来处理歧义，例如使用多个表与 GuiBase2d.RootLocalizationTable 。
- 示例 是你想要它成为的一切。如果文本捕捉工具猜测了某些参数为字符串，示例字段将包含使用在上下文中的示例。
所有这些字段都是可选的，但至少必须键或源不为空。没有两个记录可以拥有相同的键、来源和上下文。
请参阅翻译动态内容获取更多信息。
代码示例
local LocalizationService = game:GetService("LocalizationService")
local function createLocalizationTable(entries)
local localTable = Instance.new("LocalizationTable")
localTable.DevelopmentLanguage = LocalizationService.SystemLocaleId
localTable:SetEntries(entries)
return localTable
end
local entries = {
{
Key = "Hello_World", -- The 'expressionKey' to be used with GetString
Values = { -- A dictionary of keys corresponding to IETF language tags, and their translations.
["ru"] = " !", -- Russian
["fr"] = "Bonjour le monde!", -- French
["de"] = "Hallo Welt!", -- German
["en-US"] = "Hello world!", -- English
["it"] = "Ciao mondo!", -- Italian
["pt-BR"] = "Ol Mundo!", -- Portuguese
["ja"] = "", -- Japanese
["es"] = "Hola Mundo!", -- Spanish
},
},
}
local helloWorldTable = createLocalizationTable(entries)
print(helloWorldTable:GetString("en-US", "Hello_World"))概要
方法
返回一个阵列的词典，每个词典代表本地化数据的入口。
返回一个 Translator 为此本地化表中的条目，指定语言。
使用指定的 key、source 和 context 从本地化表中删除一个条目，以缩小要删除的特定条目。
使用提供的 key , source , context 和 localeId 从本地化表中删除单个语言翻译,以缩小要删除的特定条目。
从指定的本地化表中删除所有翻译，带有指定的 localeId。
设置本地化表的内容。
将本地化表入口的 上下文 字段设置为newContext，使用指定的key、source和context缩小搜索范围，以便将此更改应用到入口。
将本地化表入口的 示例 字段设置为 example ，使用指定的 key 、 source 和 context 来缩小将有这种更改应用的入口。
将本地化表入口的 键 字段设置为 newKey ,使用指定的 key , source 和 context 来缩小将有这种更改应用的入口。
将本地化表入口的 来源 字段设置为newSource，使用指定的key、source和context来缩小将有这种更改应用的入口。
将指定的本地Id的文本设置为本地化表的入口，使用指定的 key , source 和 context 来缩小包含这个更改的入口。
属性
SourceLocaleId
这个表的输入键字串的 Roblox 本地，例如 “en-us” 或 “es-es”。这通常是游戏的“开发语言”。对于融合多个本地化表对象的翻译器，它是默认本地化表的地区ID。默认为“en-us”。
方法
GetEntries
获取输入函数返回包含在给定 LocalizationTable 中的一组词典，每个词典代表本地化数据的入口。
要设置本地化表的条目，您可以使用 LocalizationTable:SetEntries() 。
阵列中的每个词典包含以下字段：
| 索引 |
|---|
返回
一个集合的词典，每个词典代表本地化数据的入口。
代码示例
The following code sample creates a LocalizationTable, sets its entries, then gets and displays its entries. In order for this example to work, a LocalizationTable instance must be located inside the LocalizationService service.
The entries variable is a table of dictionaries, each with the format required to create a LocalizationTable with LocalizationTable:SetEntries().
The get_results variable is a table of dictionaries - the same table that we created with the entries variable. We then loop through each of the tables in this dictionary to display its Values/strings.
local LocalizationService = game:GetService("LocalizationService")
local localizationTable = LocalizationService:FindFirstChild("LocalizationTable")
local entries = {
{
["Key"] = "0001",
["Source"] = "en-us",
["Values"] = {
["0001"] = "Hello Muddah, hello Fadduh.",
["0002"] = "Here I am at Camp Granada.",
["0003"] = "Camp is very entertaining.",
["0004"] = "And they say we'll have some fun if it stops raining.",
},
},
}
localizationTable:SetEntries(entries)
local get_results = localizationTable:GetEntries()
for _index, dict in pairs(get_results) do
for _key, value in pairs(dict["Values"]) do -- Loop through every key, value pair in the dictionary to print our strings
print(value)
end
endRemoveEntry
使用指定的 key、source 和 context 从本地化表中删除一个条目，以缩小要删除的特定条目。
参数
返回
RemoveEntryValue
使用提供的 key , source , context 和 localeId 从本地化表中删除单个语言翻译,以缩小要删除的特定条目。
参数
返回
SetEntries
设置本地化表的内容。
输入参数应为返回自 LocalizationTable:GetEntries() 函数的同一格式的词典阵列。
参数
返回
SetEntryContext
将本地化表入口的 上下文 字段设置为newContext，使用指定的key、source和context缩小搜索范围，以便将此更改应用到入口。
参数
返回
SetEntryExample
将本地化表入口的 示例 字段设置为 example ，使用指定的 key 、 source 和 context 来缩小将有这种更改应用的入口。
参数
返回
SetEntryKey
将本地化表入口的 键 字段设置为 newKey ,使用指定的 key , source 和 context 来缩小将有这种更改应用的入口。
参数
返回
SetEntrySource
将本地化表入口的 来源 字段设置为newSource，使用指定的key、source和context来缩小将有这种更改应用的入口。