LocalizationTable 은 번역 데이터베이스입니다. 원본 문자열과 다양한 언어에 대한 번역이 포함되어 있습니다. 이는 Translator 및 LocalizationService 자동 번역 시스템과 함께 사용되어
LocalizationTable 항목
각 로컬화 테이블에는 세트의 항목이 포함되어 있습니다. 각 항목에는 텍스트의 번역과 특수 필드가 포함되어 있습니다.
- 키 는 코드에서 빠른 해시 검색을 위한 옵션 고유 키입니다. 비어 있지 않으면 테이블에 고유해야 합니다.
- 원본 은 원본 언어의 원래 텍스트이며, 자동 번역 시스템에서 사용자 인터페이스 텍스트와 일치하도록 번역하는 데 사용됩니다. LocalizationService 에서 사
- 컨텍스트 는 텍스트가 표시된 개체의 전체 인스턴스 이름입니다. 컨텍스트는 자동 번역 시스템에서 의미 불일치를 위한 용어입니다. 원본에 대해 여러 일치가 발견되면 시스템이 가장 좋은 일치를 선택하도록
- 예제 는 원하는 대로 지정하십시오. 텍스트 캡처 도구가 문자열에 대한 일부 매개 변수를 추측하면 예제 필드에 해당 매개 변수의 예가 포함됩니다.
이 모든 필드는 선택 사항이지만, 적어도 키 또는 원본이 비어 있어야 합니다. 두 개의 항목은 동일한 키, 원본 및 컨텍스트를 가질 수 없습니다.
자세한 내용은 동적 콘텐츠 번역을 참조하십시오.
코드 샘플
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를 반환합니다.
LocalizationTable에서 지정된 key, source 및 context 를 사용하여 특정 항목을 좁혀 제거할 수 있습니다.
제공된 key, source, context 및 2>localId2>를 사용하여 번역된 단일 언어를 로컬화 테이블에서 제거합니다.
지정된 로캘 ID로 모든 번역을 로캘 테이블에서 제거합니다.
LocalizationTable의 콘텐츠를 설정합니다.
LocalizationTable 항목의 컨텍스트 필드를 newContext 로 설정하려면 지정된 key , 1> 소스1> 및 4> text4> 를 사용하여 변경 사항을 적용할 항목을 좁혀줍니다.
LocalizationTable 항목의 예시 필드를 example 로 설정하고, 지정된 key 를 사용하여, 2>소스2> 및 5> context5> 를 통해 변경 사항을 적용할 수 있는 입력을 좁혀줍니다.
LocalizationTable 항목의 키 필드를 newKey로 설정하려면 key 를 사용하여 지정된 1> key1> 및 소스 4> source4> 및 컨텍스트 7> context7> 를 사용하여 변경 사항을 적용할 입력을 좁혀줍니다.
LocalizationTable 항목의 원본 필드를 newSource 로 설정하고 지정된 key 를 사용하여 변경 사항을 적용한 후 입력을 좁혀 적용할 변경 사항을 적용하는 항목을 좁혀 적용합니다.
지정된 로캘 ID의 텍스트를 로캘화 테이블 항목에 설정하려면 지정된 key, source 및 context 을 사용하여 변경 사항을 적용할 항목을 좁혀 보았습니다.
속성
SourceLocaleId
이 테이블의 입력 키 문자열에 대한 Roblox 로캘, 예를 들어 "en-us" 또는 "es-es." 이것은 일반적으로 게임의 "개발 언어"입니다. 여러 개의 로캘 테이블 개체를 병합하는 트랜슬레이터의 경우 "en-us"의 기본 로캘입니다. 기본값은 "en-us".
메서드
GetEntries
GetCommands 함수는 지정된 LocalizationTable 에 포함된 다수의 사전 배열을 반환하며, 각 사전은 로컬화 데이터의 입력을 나타냅니다.
LocalizationTable의 항목을 설정하려면 LocalizationTable:SetEntries() 를 사용할 수 있습니다.
배열에 있는 각 사전에는 다음과 같은 필드가 포함됩니다.
<tbody><tr><td><b>키</b></td><td><code>Library.string</code></td><td>LocalizationTable의 특정 항목에 대한 검색 키입니다.</td></tr><tr><td><b>원본</b></td><td><code>Library.string</code></td><td>로컬 문자열을 형식하는 문자열입니다. 키가 제공되지 않은 경우 검색에 사용됩니다.</td></tr><tr><td><b>컨텍스트</b></td><td><code>Library.string</code></td><td>Class.Instance:GetFullName() 경로로 로컬라이제이션 테이블을 생성한 개체. 키가 제공되지 않으면 검색 사용으로 사용됩니다.</td></tr><tr><td><b>예시</b></td><td><code>Library.string</code></td><td>로컬화 로컬라이제이션지정하는 문자열. 선택적입니다.</td></tr><tr><td><b>값</b></td><td><code>사전</code></td><td>이 로컬화 항목에 대한 언어 번역의 사전입니다. 이 사전의 열쇠는 지역 식별자입니다. 값은 지역화를 적용할 언어에 대한 문자열입니다.</td></tr></tbody>
인덱스 | 유형 | 설명 |
---|
반환
각 사전이 로컬화 데이터의 입력을 나타내는 배열입니다.An array of dictionaries, where each dictionary represents an entry of localization data.
코드 샘플
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
end
RemoveEntry
LocalizationTable에서 지정된 key, source 및 context 를 사용하여 특정 항목을 좁혀 제거할 수 있습니다.
매개 변수
반환
RemoveEntryValue
제공된 key, source, context 및 2>localId2>를 사용하여 번역된 단일 언어를 로컬화 테이블에서 제거합니다.
매개 변수
반환
SetEntries
LocalizationTable의 콘텐츠를 설정합니다.
입력 매개 변수는 LocalizationTable:GetEntries() 함수에서 반환된 것과 동일한 형식의 사전 집합이어야 합니다.
매개 변수
반환
SetEntryContext
LocalizationTable 항목의 컨텍스트 필드를 newContext 로 설정하려면 지정된 key , 1> 소스1> 및 4> text4> 를 사용하여 변경 사항을 적용할 항목을 좁혀줍니다.
매개 변수
반환
SetEntryExample
LocalizationTable 항목의 예시 필드를 example 로 설정하고, 지정된 key 를 사용하여, 2>소스2> 및 5> context5> 를 통해 변경 사항을 적용할 수 있는 입력을 좁혀줍니다.
매개 변수
반환
SetEntryKey
LocalizationTable 항목의 키 필드를 newKey로 설정하려면 key 를 사용하여 지정된 1> key1> 및 소스 4> source4> 및 컨텍스트 7> context7> 를 사용하여 변경 사항을 적용할 입력을 좁혀줍니다.
매개 변수
반환
SetEntrySource
LocalizationTable 항목의 원본 필드를 newSource 로 설정하고 지정된 key 를 사용하여 변경 사항을 적용한 후 입력을 좁혀 적용할 변경 사항을 적용하는 항목을 좁혀 적용합니다.