[Unity] 다중 언어 (Localization)

---

다중 언어 Localization

---

다중 언어(Localization) 사용법

1. Package Manager -> Localization 패키지 설치

2. Localization Setting 생성
Project Settiongs View -> Localization - Create (폴더에 저장)

3.Available Locals 추가
Add Locale - 지원할 Loclas(한국어, 영어) 추가. (사용할 언어의 폰트 추가 설치)

4. 기본 언어 설정
Add Locale - 지원할 Loclas(한국어, 영어) 추가. (사용할 언어의 폰트 추가 설치)

• Specific Locale Selector : 프로젝트에서 사용할 언어
• Project Local Identifier : 해당 프로젝트에서 기본으로 사용할 언어

5. 테이블 생성
Windows - Asset Management - Localization Tables 열기
New Table Collection (사용할 언어 선택, 테이블 이름 지정)
Import, Export 가능 - CSV로 CSV 정보를 사용 가능.

---

UI - Text

1. UI에 Localize String Event 컴포넌트 추가
TextMeshPro - 메뉴 버튼 -> Localize (Localize 컴포넌트 추가)

2. Table/Key 값으로 Text 출력
String Reference에서 Key를 선택하면 키값에 맞는 출력할 내용이 출력됩니다.

3. 언어에 맞게 글자 조정
Windows - Asset Management - Localization Scene Controls

• Active Local ( 변경할 언어 ) 선택
• String Table ( 변경할 Key가 있는 테이블 선택)
• Track Changes 체크

UI의 폰트 사이즈 변경하면 Game Object Localize 컴포넌트가 생성된다. -> 언어에 맞게 글자 조정 가능
완료 시 Localization Scene Controls 의 설정 초기화

---

코드로 UI변경

1. index를 이용해 언어 변경
LocalizationSettings.SelectedLocale = LocalizationSettings.AvailableLocales.Locales[index];
ProjectSetting - Localization에 Index를 이용해 언어 변경 가능

2. Table, Key의 이름으로 Text 변경
GetComponent<LocalizeStringEvent>().StringReference.SetReference(tableName, itemValue.itemName);
컴포넌트를 가져와 변경

코드 예시

// 언어 토글
void OnClickLocalChangeButton()
{
    var locales = LocalizationSettings.AvailableLocales.Locales;
    LocalizationSettings.SelectedLocale =
        LocalizationSettings.SelectedLocale == locales[0] ? locales[1] : locales[0];
}


public void LocalizeTextString(string tableName, string keyName)
{
    GetText((int)Texts.LoadingText).GetComponent<LocalizeStringEvent>().StringReference
        .SetReference(tableName, keyName);
}

// TestTable - Test key 로 출력
void OnClickChangeTestButton()
{
    LocalizeTextString("TestTable", "Test_Key");
}

// TestTable - Loading key 로 출력
void OnClickChangeLoadingButton()
{
    LocalizeTextString("TestTable", "Loading_Key");
}

---

App 이름 변경

ProjectSetting - Localization - Metadata - (+) - App info - 테이블 생성 -> New Entry로 이름 추가.

---

UI- Image Sprite 변경

1. Asset Table 생성
2. New Entry(스프라이트 추가)
3. 사용할 UI 에 Localize Sprite Event컴포넌트 추가
4. Localized Asset Reference 설정

---

메모

다중 언어(Localization)

---