Unity

Unity Localization (2)

CCS_Cheese 2025. 1. 4. 16:55

이번 시간에는 Unity Localization을 Google Sheets를 연동하는 방식에 대해 알아보려고 합니다.

이전 글에서는 Unity Localization은 무엇인지, 간단하게 다국어를 지원하는 것을 해보았는데요. 다국어 언어들을 Google Sheets에서 관리하고 Unity는 Sheets의 데이터를 받아서 언어별로 표기할 수 있습니다.

 

이전 게시글을 확인하여 Localization의 초기 세팅을 확인해 볼 수 있습니다.

https://develophyun.tistory.com/1

 

Unity_Localization

이번 시간에는 Unity에서 다국어 지원 하는 방법에 대해 알아보도록 하겠습니다.다국어 지원이란, 하나의 게임이 여러 언어로 플레이할 수 있도록 번역 및 현지화된 인터페이스, 텍스트, 음성 등

develophyun.tistory.com

 

Google Sheet 생성 및 초기 설정

여기서부터는 Google Sheet 연동을 해보려고 합니다.

먼저 Unity에 연동할 Google Sheet를 생성해 보겠습니다.

Google Sheet 생성

  • Key, 다국어 지원할 국가 코드 리스트를 입력해 줍니다.
  • 여기서의 Key가 Unity에서 사용될 Entry Key입니다.

Google Cloud Setting - API 및 서비스

생성한 Google Sheet의 Google 계정의 Google Cloud에 접속하여 New Project를 하여 새로운 프로젝트를 생성합니다.

Project 생성
Google Sheets API 사용

OAuth 동의 설정

  • 선택한 Project가 맞는지 확인합니다.
  • OAuth 동의 체크
  • User Type : 외부 설정
  • 만들기 생성 

동의 상세 설정

  • 애플리케이션 이름 설정 : 기존 프로젝트이름과 달라도 상관없음.
  • 사용자 지원 이메일 : 사용자 동의에 대해 문의하는 용도
  • 개발자 지원 메일 설정 : 개발자 연락처 정보 업데이트
  • 위 3가지의 설정 완료 후 저장 후 계속하기 선택
  • 범위 설정 별도의 설정 없이 저장 후 계속하기

테스트 사용자 설정 

테스트 사용자 등록

해당 프로젝트의 테스트 사용자를 등록하는 설정 화면으로, 기존 Google Sheet의 사용자 외 다른 이메일을 지정할 수 있습니다. 여기서는 기존 Google Sheet Gmail을 사용합니다. Add Users 후 저장 후 계속하기를 선택합니다.

 

 

사용자 인증 정보 업데이트

사용자 인증 정보 업데이트

앞서 API 및 서비스 설정, OAuth 동의 화면 설정을 마친 뒤 사용자 인증 정보를 업데이트하여야 합니다.

Unity에서 연동하는 용도로 OAuth 2.0 클라이언트 ID를 추가 생성합니다.

  • 사용자 인증 정보 만들기 클릭 
  • OAuth 클라이언트 ID 클릭

애플리케이션 유형 설정

  • 애플리케이션 유형을 선택합니다 
    • 여기서 Unity에서 대응하려는 플랫폼과 별개로 데스크톱 앱으로 설정하면 됩니다.
      Unity에서 생성할 프로젝트가 Android, iOS여도, 애플리케이션 유형은 데스크톱 앱으로 설정
  • 설정을 완료 한 뒤 이름 지정 및 만들기 클릭.

생성 완료 화면

생성이 완료되면 클라이언트 ID, 클라이언트 보안 비밀번호가 생성됩니다. 위 두 가지의 값은 사용하려는 사용자만 알고 있어야 되고, 보호되어야 합니다. 

 

여기까지 진행을 하였으면, Google Sheet를 연결하기 위한 Google Cloud 프로젝트, API 설정 권한 설정을 완료했다고 볼 수 있습니다.

 

Unity 설정

Google Sheet 생성
Sheet Provider 설정

  • Authentication 방식 설정 : OAuth
  • Client Id, Client Sercet 입력 : 앞 서 Cloud에서 설정한 Client Id와 Secret을 입력합니다.
  • 입력 완료 후 Authorize를 클릭하면 Gmail 로그인 창으로 이동합니다.
  • 여기서 Cloud에서 설정하였던 테스트 계정으로 Gmail을 로그인합니다.
  • 동의 설정 및 확인을 통해 인증을 완료합니다.

 

  • String Table Collection 설정 변경
  • Extensions 추가 : Google Sheets
  • 앞서 생성한 Sheets Service Provider를 연결
  • Mapped Columns를 설정 : Key, 지원하는 다국어 리스트 Locale 설정

※ 중요한 Tip 이미지와 같이 Key Column이 가장 마지막에 들어가는 것이 아닌 제일 처음에 들어가야지 정상적으로 Pull이 가능합니다.