LocalizationService
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
LocalizationService 는 자동 번역을 처리하는 서비스입니다.
자동 텍스트 교체에 사용되는 LocalizationTable 개체를 위한 저장소입니다.
LocalizationService는 자식 로컬화 테이블을 사용하여 자동으로 텍스트를 교체하지 않으면 GuiBase2d.RootLocalizationTable 이 가이드 개체 또는 상위 개체에 지정되지 않은 경우에만 자동 번역을 사용합니다.
요약
속성
코어 및 내부 기능을 로컬화하는 데 사용되는 로캐 아이디입니다.
로컬 플레이어가 운영 체제에 설정한 로캘 아이디입니다.
메서드
로컬화된 코어 스크립트를 위해 LocalizationTable 개체 목록을 반환합니다.
자동 로컬라이제이션사용할 모든 입력을 가져옵니다.
로컬 데이터로 번역을 사용하는 경우 Translator를 반환합니다.
플레이어의 클라이언트 IP 위치에 따라 국가/지역 코드 문자열을 반환합니다.
클라우드에서 사용할 수 있는 인수 지역화 테이블 LocalizationTable 을 위해 잠깐 기다린 다음 반환합니다. 사용 가능한 경우 Translator 인스턴스를 반환합니다.
클라우드에 있는 플레이어의 로캘에 대한 LocalizationTable 클라우드에 있는 플레이어의 로캘에 대한 Translator 인스턴스를 로드합니다. - 가능하면. Class.LocalizationTable 인스턴스를 반환합니다.
속성
RobloxLocaleId
이 속성은 코어 및 내부 기능의 현지화를 위해 사용된 로캘 ID를 표시합니다. CoreGui 의 경우 로캘에 대한 두 문자 코드(예: en-us 의 경우)가 포함된 문자열을 반환합니다.
SystemLocaleId
이 속성은 로컬 플레이어가 운영 체제에 설정한 로컬 언어 아이디를 표시합니다.This property shows the locale id that the local player has set for their operating system.
이렇게 하면 지역에 대해 두 문자 코드(예: "en-us")가 있는 문자열이 반환됩니다.
또한 로블록스 계정에 대해 로컬화하는 콘텐츠를 사용하기 위해 사용자가 설정한 로컬 아이디 Player.LocaleId 를 참조하십시오. 이 값은 Roblox가 플레이어의 로컬 언어를 지원하지 않을 때 다른 값이 됩니다.
메서드
GetTableEntries
Class.LocalizationTable:GetEntries() 에 설명된 대로 각 요소의 반환된 배열 은 스스로 배열
이 함수는 개체가 GuiBase2d 와 GuiBase2d.AutoLocalize 를 사용하는 경우에 모두 입력을 반환합니다. GuiBase2d 가 활성화된 경우에는 실제로 로컬화되지 않습니다.
테이블 정렬은 다음과 같습니다.The ordering of the tables is as follows:
- 먼저, 개체의 가장 오래된 조상(제
- 다음으로, LocalizationTable 하위의 테이블 중 LocalizationService 하위의 테이블을 참조합니다.
- 마지막으로, 클라우드 LocalizationTable 앱은 배열에 연결됩니다. 클라우드 LocalizationTable 또는 클라우드 LocalizationTable 가 아직 로드되지 않은 경우 이 단계에 표시되지 않습니다.
이 함수는 생성되지 않습니다. 클라우드에서 로드될 때까지 기다리지 않습니다. LocalizationTable 에 로드됩니다.
매개 변수
반환
배열의 배열, 각 배열이 LocalizationTable:GetEntries() 에 설명된 대로 동일한 형식으로 있습니다.
GetTranslatorForPlayer
이 함수는 플레이어를 인수로 사용하고 해당 지역에 대한 번역을 수행하는 Translator 인스턴스를 반환합니다. 사용 가능한 경우 로컬화
이 함수는 생성되지 않습니다. 클라우드에서 로드될 때까지 기다리지 않습니다. LocalizationTable 에 로드됩니다.
또한 참조하십시오.
- LocalizationService:GetTranslatorForPlayerAsync() 는 이 함수와 동일한 기능을 가지고 있지만, 클라우드에서 LocalizationTable 로 로드될 때까지 생성됩니다.
- LocalizationService:GetTranslatorForLocaleAsync(), 지정된 언어를 사용하는 번역에 대해 번역기를 반환합니다.
매개 변수
Class.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 로 로드된 지역의 경우 해당 지역에 대한 번
이 함수는 오류가 발생하므로 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로 로드된 경우에만
이 함수는 오류가 발생하므로 pcall() 에 감싸여야 합니다.
또한 참조하십시오.
- LocalizationService:GetTranslatorForPlayer() , 클라우드에서 플레이어의 로컬 언어를 로드하기 위해 기다리지 않고 동작하는 동일한 기능을 수행합니다. 이 함수는 사용하지 않도록 권장되며 새 작업에서 사용하지 마십시오.
- LocalizationService:GetTranslatorForLocaleAsync(), 지정된 언어를 사용하는 번역에 대해 번역기를 반환합니다.
매개 변수
Class.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