Unity (Strings)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

사용 가능:

모든 유료 요금제

Unity plugin은 Unity 개발자가 소스 문자열과 번역을 Phrase Strings와 동기화하여 현지화 작업을 관리할 수 있게 해주는 Unity Localization 패키지입니다.

이 plugin은 Unity 개발자가 Unity Localization, 특히 String Table Collections을 사용하거나 사용할 계획이라고 가정합니다. Unity 설명서를 참조하여 Unity Localization을 시작하십시오.

참고

지속적인 개선으로 사용자 인터페이스가 동영상에 표시된 것과 완전히 같지 않을 수 있습니다.

plugin 설정

필수 조건

로캘 세트와 하나 이상의 문자열 테이블 컬렉션을 생성합니다.
이를 일부 텍스트 개체와 연결합니다(및/또는 Unity 스크립트에서 프로그래밍 방식으로 사용하기 시작합니다).

설치 및 구성

plugin을 설치하는 방법은 여러 가지가 있습니다:

Asset Store에서 설치합니다.
로컬 .unitypackage 파일을 사용자 지정 패키지로 가져와 패키지 아카이브에서 설치합니다.
다음 방법 중 하나로 로컬에서 체크아웃한 소스 코드로부터 설치합니다:
- 소스를 YourProject/Packages/com.phrase.plugin 디렉터리에 직접 체크아웃합니다.
- unity_plugin 디렉터리에 대한 심볼릭 링크를 YourProject/Packages에 com.phrase.plugin으로 생성합니다.

설치가 완료되면 Phrase Provider를 프로젝트의 에셋에 추가하고 구성을 완료합니다:

연결 환경을 설정하고 Phrase에서 생성된 API 액세스 토큰을 제공합니다.
사용 가능한 프로젝트를 가져와 목록에서 하나를 선택합니다.

로캘 목록은 자동으로 가져옵니다.
Unity와 Phrase Strings 간에 로캘이 일치하지 않는 경우, 관련 옵션을 선택하여 누락된 로캘을 로컬 또는 Phrase에서 생성합니다.
Phrase와 연결하고 동기화할 문자열 테이블을 선택하십시오.
어떤 로캘을 Unity로 풀하고 어떤 로캘을 Phrase로 푸시할지 선택하십시오. 이 선택은 전역 풀/푸시(Phrase 공급자 인스펙터)와 개별 문자열 테이블 푸시/풀(테이블 확장 서랍) 모두에 영향을 미칩니다.

설정은 전역적이며 Phrase 확장 기능(연결된 컬렉션에서만 작동)과 Phrase 창(연결된 문자열 테이블의 키만 표시) 모두에 영향을 미칩니다.

초기 키 목록(일반적으로 소스 로캘만 해당)을 이제 Phrase Strings로 푸시할 수 있습니다. 대상 로캘로 번역되면 동일한 Phrase Provider 화면을 통해 키가 Unity로 다시 풀됩니다.

참고

Push and pull 작업은 문자열 테이블 컬렉션의 Phrase 확장 기능에서도 사용할 수 있습니다.

plugin 사용

Push 및 Pull

사용자는 Phrase Provider 화면(연결된 모든 문자열 테이블을 Phrase와 동기화함)과 개별 문자열 테이블의 Phrase 확장 서랍에서 로컬라이제이션 키를 푸시하고 풀할 수 있습니다.

문자열 테이블이 Phrase 공급자와 연결되면 인스펙터에 Phrase 서랍이 표시되어 테이블에서 콘텐츠를 푸시하거나 풀할 수 있습니다. Phrase 공급자와 연결되지 않은 문자열 테이블에는 Phrase 서랍이 없으며, 문자열 테이블 컬렉션이 연결된 경우에만 확장 기능이 나타납니다.

사용자는 일반적으로 번역을 여러 문자열 테이블 컬렉션으로 구성합니다. 예를 들어 게임 섹션이나 참조되는 항목 유형(예: 무기, 아이템, 캐릭터 등)을 기준으로 할 수 있습니다. 이 경우 Phrase Strings에 있는 모든 번역 키 중 일부만 포함된 컬렉션을 연결해야 합니다. Only Keys Matching 드롭다운에서 옵션을 선택하여 특정 테이블로 푸시/풀할 키의 하위 집합을 지정하십시오:

Key Prefix

이름에 지정된 접두사가 있는 키만 대상 테이블로 가져오기(풀)됩니다. Unity 키 이름에는 접두사 자체가 포함되지 않습니다. 푸시할 때 전체 테이블이 Phrase로 업로드되고 접두사가 키 이름에 자동으로 추가됩니다.
태그

일치하는 tag이 있는 키만 대상 테이블로 가져옵니다. 태그를 푸시하면 이 테이블의 모든 키에 태그가 할당됩니다.
None

풀(pull)하면 모든 Phrase 키가 대상 테이블로 가져와집니다(일반적으로 Phrase와 연결된 컬렉션이 하나만 있는 경우).

참고

테이블 확장 프로그램 서랍에서 푸시 및 풀을 수행하면 Phrase 공급자 검사기에서 선택한 로캘 목록이 적용됩니다. 단일 테이블 컬렉션의 콘텐츠만 동기화하려면 Phrase 확장 프로그램에서 수행하십시오. 연결된 모든 콘텐츠를 동기화하려면 Phrase 공급자를 사용하십시오.

문자열 테이블을 푸시하기 전에 Phrase 공급자 또는 확장 프로그램 서랍에서 대상 로캘이 선택되었는지 확인하십시오. 대상 로캘을 선택하지 않고 푸시를 수행하면 Phrase Strings에서 작업이 생성되거나 업데이트되지만, 해당 작업은 TMS로의 자동 프로젝트 생성 동기화와 같은 다운스트림 통합을 통해 전파되지 않습니다. 이 오류는 Unity나 Phrase Strings에서 눈에 보이는 오류 없이 발생합니다.

복구하려면 누락된 대상 로캘을 Phrase Strings의 해당 작업에 추가하고 다운스트림 통합을 다시 트리거하십시오. 대상 로캘이 Unity 프로젝트에 전혀 구성되어 있지 않으면, Unity 측에서도 로캘을 설정할 때까지 번역을 Unity로 다시 내보내기가 작동하지 않습니다.

Phrase 창

메뉴에서 Window/Phrase를 선택하여 Phrase 편집자 창을 열고 필요에 따라 기본 인터페이스에 연결합니다.

Phrase 창에는 로컬라이제이션 씬의 텍스트 객체에 연결된 키가 나열되며, 해당 메타데이터를 편집하고 스크린샷을 업로드할 수 있습니다.

선택 항목에서 Phrase가 활성화된 문자열 테이블 및 관련 키에 연결된 모든 텍스트 객체가 표시됩니다. 사용자는 키 설명 및 최대 글자 길이를 설정할 수 있으며, 이는 다음에 포함된 문자열 테이블이 푸시될 때 Phrase와 동기화됩니다.

참고

문자열 테이블 컬렉션 편집자에서 키 메타데이터(설명 및 최대 길이 등)를 보고 편집할 수도 있습니다.

Update screenshot 버튼을 사용하여 현재 게임 뷰의 스크린샷을 내보내고 나열된 모든 Phrase 키에 첨부합니다.

키 이름 옆의 Open in Phrase를 클릭하여 Phrase Strings Editor에서 키를 엽니다.