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 인스턴스.
코드 샘플
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
GetCountryRegionForPlayerAsync
플레이어의 클라이언트 IP 위치에 따라 국가/지역 코드 문자열을 반환합니다. 지원되는 국가/지역 코드는 다음과 같습니다.
<tbody><tr><td>미국</td><td>미국</td></tr><tr><td>GB</td><td>영국</td></tr><tr><td>CA</td><td>캐나다</td></tr><tr><td>AF</td><td>아프가니스탄</td></tr><tr><td>도끼</td><td>알랜드 섬</td></tr><tr><td>AL</td><td>알바니아</td></tr><tr><td>DZ</td><td>알제리</td></tr><tr><td>AS</td><td>미국 사모아</td></tr><tr><td>AD</td><td>안도라</td></tr><tr><td>AO</td><td>앤골라</td></tr><tr><td>인공 지능</td><td>앤길라</td></tr><tr><td>AQ</td><td>남극</td></tr><tr><td>AG</td><td>안티구아 및 바부다</td></tr><tr><td>AR</td><td>아르헨티나</td></tr><tr><td>오전</td><td>아르메니아</td></tr><tr><td>AW</td><td>아루바</td></tr><tr><td>오디오</td><td>호주</td></tr><tr><td>에</td><td>오스트리아</td></tr><tr><td>AZ</td><td>아제르바이잔</td></tr><tr><td>BS</td><td>바하마</td></tr><tr><td>BH</td><td>바레인</td></tr><tr><td>BD</td><td>방글라데시</td></tr><tr><td>비</td><td>바바도스</td></tr><tr><td>에 의해</td><td>벨라루스</td></tr><tr><td>이다</td><td>벨기에</td></tr><tr><td>BZ</td><td>벨리즈</td></tr><tr><td>BJ</td><td>벤인</td></tr><tr><td>BM</td><td>버뮤다</td></tr><tr><td>버텍</td><td>부탄</td></tr><tr><td>보</td><td>볼리비아</td></tr><tr><td>BQ</td><td>보나이어, 세인트 유스타투스 및 사바</td></tr><tr><td>바</td><td>보스니아 헤르체고비나</td></tr><tr><td>BW</td><td>보츠와나</td></tr><tr><td>BV</td><td>부벡 섬</td></tr><tr><td>BR</td><td>브라질</td></tr><tr><td>IO</td><td>영국 인도 영역</td></tr><tr><td>번</td><td>브루나이 다루살람</td></tr><tr><td>배경</td><td>불가리아</td></tr><tr><td>BF</td><td>부르키나 파소</td></tr><tr><td>BI</td><td>부룬디</td></tr><tr><td>KH</td><td>캄보디아</td></tr><tr><td>평면</td><td>카메룬</td></tr><tr><td>이력서</td><td>케이프 베르데</td></tr><tr><td>KY</td><td>케이맨 제도</td></tr><tr><td>콘텐츠 프로토콜</td><td>중앙아프리카 공화국</td></tr><tr><td>TD</td><td>차드</td></tr><tr><td>CL</td><td>칠레</td></tr><tr><td>중국</td><td>중국</td></tr><tr><td>CX</td><td>크리스마스 섬</td></tr><tr><td>CC</td><td>코코스 섬</td></tr><tr><td>코</td><td>콜롬비아</td></tr><tr><td>킬로미터</td><td>코모로</td></tr><tr><td>CG</td><td>콩고</td></tr><tr><td>컴팩트 디스크</td><td>콩고(DRC)</td></tr><tr><td>CK</td><td>쿠크 섬</td></tr><tr><td>CR</td><td>코스타리카</td></tr><tr><td>CI</td><td>코트 드'아이부</td></tr><tr><td>HR</td><td>크로아티아</td></tr><tr><td>CW</td><td>쿠라소</td></tr><tr><td>사이</td><td>사이프러스</td></tr><tr><td>CZ</td><td>체코 공화국</td></tr><tr><td>DK</td><td>덴마크</td></tr><tr><td>DJ</td><td>지부티</td></tr><tr><td>DM</td><td>도미니카</td></tr><tr><td>도</td><td>도미니카 공화국</td></tr><tr><td>EC</td><td>에콰도르</td></tr><tr><td>EG</td><td>이집트</td></tr><tr><td>SV</td><td>엘살바도르</td></tr><tr><td>GQ</td><td>에콰도르</td></tr><tr><td>ER</td><td>에리트레아</td></tr><tr><td>그 외</td><td>에스토니아</td></tr><tr><td>ET</td><td>에티오피아</td></tr><tr><td>FK</td><td>파로 군도 (Falkland Islands)</td></tr><tr><td>FO</td><td>Faroe 제도</td></tr><tr><td>FJ</td><td>피지</td></tr><tr><td>피</td><td>핀란드</td></tr><tr><td>FR</td><td>프랑스</td></tr><tr><td>GF</td><td>프랑스 가이아나</td></tr><tr><td>PF</td><td>프랑스 폴리네시아</td></tr><tr><td>오프</td><td>프랑스 남부 영역</td></tr><tr><td>GA</td><td>가보</td></tr><tr><td>GM</td><td>감비아</td></tr><tr><td>GE</td><td>조지아</td></tr><tr><td>DE</td><td>독일</td></tr></tbody>
코드 | 국가/지역 |
---|
<tbody><tr><td>GH</td><td>가나</td></tr><tr><td>GI</td><td>지브롤터</td></tr><tr><td>GR</td><td>그리스</td></tr><tr><td>GL</td><td>그린랜드</td></tr><tr><td>제너럴 데이터</td><td>그레나다</td></tr><tr><td>GP</td><td>가델로프</td></tr><tr><td>가이</td><td>가웃</td></tr><tr><td>GT</td><td>과테말라</td></tr><tr><td>GG</td><td>저지</td></tr><tr><td>GN</td><td>기니</td></tr><tr><td>GW</td><td>기니 비사우</td></tr><tr><td>GY</td><td>가이아나</td></tr><tr><td>숙련자</td><td>하이티</td></tr><tr><td>흠</td><td>헤어드 섬과 맥도날드 섬</td></tr><tr><td>VA</td><td>거룩한 보석</td></tr><tr><td>HN</td><td>온두라스</td></tr><tr><td>HK</td><td>홍콩</td></tr><tr><td>HU</td><td>헝가리</td></tr><tr><td>이다</td><td>아이슬란드</td></tr><tr><td>에</td><td>인도</td></tr><tr><td>아이디</td><td>인도네시아</td></tr><tr><td>지능</td><td>이라크</td></tr><tr><td>IE</td><td>아일랜드</td></tr><tr><td>나는</td><td>맨 섬</td></tr><tr><td>IL</td><td>이스라엘</td></tr><tr><td>그것의</td><td>이탈리아</td></tr><tr><td>JM</td><td>자메이카</td></tr><tr><td>JP</td><td>일본</td></tr><tr><td>JE</td><td>저지</td></tr><tr><td>조</td><td>조던</td></tr><tr><td>KZ</td><td>카자흐스탄</td></tr><tr><td>KE</td><td>케냐</td></tr><tr><td>KI</td><td>키리바티</td></tr><tr><td>KR</td><td>한국</td></tr><tr><td>KW</td><td>쿠웨이트</td></tr><tr><td>KG</td><td>키르기스탄</td></tr><tr><td>LA</td><td>라오스</td></tr><tr><td>레벨</td><td>라트비아</td></tr><tr><td>LB</td><td>레바논</td></tr><tr><td>LS</td><td>레소토</td></tr><tr><td>LR</td><td>리비아</td></tr><tr><td>LY</td><td>리비아</td></tr><tr><td>LI</td><td>리히텐슈타인</td></tr><tr><td>LT</td><td>리투아니아</td></tr><tr><td>LU</td><td>루마니아</td></tr><tr><td>모</td><td>마카오</td></tr><tr><td>MK</td><td>마케도니아</td></tr><tr><td>MG</td><td>마다가스카르</td></tr><tr><td>MW</td><td>말라위</td></tr><tr><td>나의</td><td>말레이시아</td></tr><tr><td>MV</td><td>말레이시아</td></tr><tr><td>ML</td><td>Mali</td></tr><tr><td>MT</td><td>몰타</td></tr><tr><td>MH</td><td>마샬 군도</td></tr><tr><td>MQ</td><td>마티니크</td></tr><tr><td>MR</td><td>모리타니아</td></tr><tr><td>MU</td><td>모리셔스</td></tr><tr><td>예</td><td>마요트</td></tr><tr><td>매그넥트</td><td>멕시코</td></tr><tr><td>펌프</td><td>미크로네시아</td></tr><tr><td>MD</td><td>모л도바</td></tr><tr><td>MC</td><td>모나코</td></tr><tr><td>MN</td><td>몽골</td></tr><tr><td>나는</td><td>몬테네그로</td></tr><tr><td>MS</td><td>몬트서라트</td></tr><tr><td>마</td><td>모로코</td></tr><tr><td>MZ</td><td>모잠비크</td></tr><tr><td>음</td><td>미얀마</td></tr><tr><td>나</td><td>나미비아</td></tr><tr><td>NR</td><td>나우루</td></tr><tr><td>DP</td><td>네팔</td></tr><tr><td>네덜란드인</td><td>네덜란드</td></tr><tr><td>AN</td><td>네덜란드 령</td></tr><tr><td>NC</td><td>새로운 캘레도니아</td></tr><tr><td>뉴질랜드</td><td>뉴질랜드</td></tr><tr><td>NI</td><td>니카라과</td></tr><tr><td>네</td><td>니제르</td></tr><tr><td>NG</td><td>나이지리아</td></tr><tr><td>누</td><td>니우</td></tr><tr><td>NF</td><td>노퍽 섬</td></tr><tr><td>MP</td><td>북마리아나 군도</td></tr><tr><td>아니요</td><td>노르웨이</td></tr><tr><td>오M</td><td>오만</td></tr></tbody>
코드 | 국가/지역 |
---|
<tbody><tr><td>PK</td><td>파키스탄</td></tr><tr><td>PW</td><td>파라우</td></tr><tr><td>PS</td><td>팔레스타인</td></tr><tr><td>팔레스타인</td><td>파나마</td></tr><tr><td>PG</td><td>파푸아 뉴 기니</td></tr><tr><td>PY</td><td>파라과이</td></tr><tr><td>PE</td><td>페루</td></tr><tr><td>PH</td><td>필리핀</td></tr><tr><td>PN</td><td>피트케어 섬</td></tr><tr><td>PL</td><td>폴란드</td></tr><tr><td>PT</td><td>포르투갈</td></tr><tr><td>홍보</td><td>푸에르토리코</td></tr><tr><td>QA</td><td>카타르</td></tr><tr><td>다시</td><td>다시 만나기</td></tr><tr><td>RO</td><td>루마니아</td></tr><tr><td>RU</td><td>러시아 연방</td></tr><tr><td>RW</td><td>르완다</td></tr><tr><td>BL</td><td>세인트 바르텔리미</td></tr><tr><td>SH</td><td>세인트 헬레나, 어센션 및 트리스탄 다 쿠냐</td></tr><tr><td>KN</td><td>세인트 키츠 및 네비스</td></tr><tr><td>LC</td><td>세인트 루시아</td></tr><tr><td>오른쪽</td><td>세인트 마틴</td></tr><tr><td>오후</td><td>세인트 피에르 및 미켈롱</td></tr><tr><td>VC</td><td>세인트 빈센트 및 그레나딘</td></tr><tr><td>WS</td><td>사모아</td></tr><tr><td>스몰</td><td>산 마리노</td></tr><tr><td>ST</td><td>사오 토메 및 프린시페</td></tr><tr><td>사우디아라비아</td><td>사우디아라비아</td></tr><tr><td>스니</td><td>세네갈</td></tr><tr><td>RS</td><td>세르비아</td></tr><tr><td>SC</td><td>세이셸</td></tr><tr><td>SL</td><td>시에라 레오네</td></tr><tr><td>SG</td><td>싱가포르</td></tr><tr><td>SX</td><td>신트 마틴</td></tr><tr><td>SK</td><td>슬로바키아</td></tr><tr><td>SI</td><td>슬로베니아</td></tr><tr><td>SB</td><td>솔로몬 제도</td></tr><tr><td>이므로</td><td>소말리아</td></tr><tr><td>ZA</td><td>남아프리카</td></tr><tr><td>GS</td><td>남조지아 및 남샌드위치 제도</td></tr><tr><td>SS</td><td>남수단</td></tr><tr><td>ES</td><td>스페인</td></tr><tr><td>LK</td><td>스리랑카</td></tr><tr><td>SR</td><td>수리남</td></tr><tr><td>SJ</td><td>스발바드 및 요한 마이엔</td></tr><tr><td>SZ</td><td>스와질랜드</td></tr><tr><td>세</td><td>스웨덴</td></tr><tr><td>CH</td><td>스위스</td></tr><tr><td>트윗</td><td>대만</td></tr><tr><td>TJ</td><td>타지키스탄</td></tr><tr><td>TZ</td><td>탄자니아</td></tr><tr><td>TH</td><td>태국</td></tr><tr><td>TL</td><td>동티모르</td></tr><tr><td>TG</td><td>토고</td></tr><tr><td>TK</td><td>토켈라우</td></tr><tr><td>에</td><td>툰가</td></tr><tr><td>티 티</td><td>트리니다드 및 토바고</td></tr><tr><td>TN</td><td>튀니젤리아</td></tr><tr><td>TR</td><td>터키(터키)</td></tr><tr><td>TM</td><td>터크메니스탄</td></tr><tr><td>TC</td><td>터크스 및 카이코스 제도</td></tr><tr><td>TV</td><td>투발루</td></tr><tr><td>UG</td><td>우간다</td></tr><tr><td>사용자 획득</td><td>우크라이나</td></tr><tr><td>AE</td><td>아랍에미리트</td></tr><tr><td>음</td><td>미국 소규모 외부 섬</td></tr><tr><td>UI</td><td>우루과이</td></tr><tr><td>UZ</td><td>우즈베키스탄</td></tr><tr><td>VU</td><td>바누아투</td></tr><tr><td>VE</td><td>베네수엘라</td></tr><tr><td>VN</td><td>베트남</td></tr><tr><td>VG</td><td>버진 아일랜드 (영국)</td></tr><tr><td>VI</td><td>버진 아일랜드 (미국)</td></tr><tr><td>WF</td><td>월리스 및 푸투나</td></tr><tr><td>EH</td><td>서사하라</td></tr><tr><td>예</td><td>예멘</td></tr><tr><td>ZM</td><td>잠비아</td></tr><tr><td>ZW</td><td>잠비아</td></tr><tr><td>CU</td><td>쿠바</td></tr><tr><td>IR</td><td>이란</td></tr><tr><td>시스템</td><td>시리아</td></tr><tr><td>KP</td><td>북한</td></tr></tbody>
코드 | 국가/지역 |
---|
또한 참조하십시오.
- PolicyService:GetPolicyInfoForPlayerAsync() , 지역 위치, 나이 그룹 및 플랫폼에 기반한 플레이어에 대한 정책 정보를 반환합니다.
매개 변수
당신이 국가/지역 정보를 얻고 있는 플레이어.
반환
플레이어의 국가/지역 코드를 나타내는 문자열입니다.
코드 샘플
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)
end
GetTranslatorForLocaleAsync
이 함수는 지역 코드를 인수로 사용하며, 클라우드에서 LocalizationTable 로 로드된 지역의 경우 해당 지역에 대한 번
이 함수는 오류가 발생하므로 pcall() 에 감싸여야 합니다.
또한 참조하십시오.
- LocalizationService:GetTranslatorForPlayer() 은 제공된 플레이어의 지역에 해당하는 번역기를 가져옵니다. 이 함수는 사용하지 않기 위한 권장 사항이며 새 작업에서 사용하지 마십시오.
- LocalizationService:GetTranslatorForPlayerAsync()는 클라우드에서 제공된 플레이어의 로컬에 대해 LocalizationTable로 로드되고 다음으로 해당 플레이어의 로컬에 대해 해당하는 번역기를 가져옵니다.
매개 변수
Roblox에서 지원하는 언어 또는 지역 코드입니다.
반환
지정된 지역에 대한 Translator 인스턴스.
코드 샘플
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)
end
GetTranslatorForPlayerAsync
이 함수는 플레이어를 인수로 사용하며, 클라우드에서 해당 플레이어의 지역 LocalizationTable로 로드된 경우에만
이 함수는 오류가 발생하므로 pcall() 에 감싸여야 합니다.
또한 참조하십시오.
- LocalizationService:GetTranslatorForPlayer() , 클라우드에서 플레이어의 로컬 언어를 로드하기 위해 기다리지 않고 동작하는 동일한 기능을 수행합니다. 이 함수는 사용하지 않도록 권장되며 새 작업에서 사용하지 마십시오.
- LocalizationService:GetTranslatorForLocaleAsync(), 지정된 언어를 사용하는 번역에 대해 번역기를 반환합니다.
매개 변수
Class.Player 를 사용하여 Translator 를 얻고 있습니다.
반환
지정된 지역에 대한 Translator 인스턴스.
코드 샘플
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