Google Play 게임즈 서비스 설정하기

이 페이지에서는 Google Play Console을 사용하여 Android 게임에 Google Play 게임즈 서비스를 설정하는 방법을 설명합니다. Play Console을 사용하면 한곳에서 게임 서비스를 관리하고 게임 승인 및 인증에 사용되는 메타데이터를 구성할 수 있습니다.

Play Console에 게임을 추가하려면 다음 일반적인 단계를 따릅니다.

  • 게임의 게임 프로젝트를 만들고 게임의 이름 및 설명과 같은 세부정보를 지정합니다.

  • 게임 승인 및 인증에 필요한 사용자 인증 정보를 만들고 Google Play 게임즈 서비스에 연결합니다.

시작하기 전에

Google Play 게임즈 서비스를 구성하기 전에 다음 단계를 완료하세요.

Google Play 개발자 계정 만들기

Google Cloud 프로젝트 만들기

Google Cloud 프로젝트를 설정해야 합니다. 자세한 내용은 다음을 참고하세요.

Play Console을 사용하려면 프로젝트에 사용할 API를 사용 설정해야 합니다.

콘솔

Google Play Game Services API 사용 설정

gcloud 

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Play Console에 로그인

로그인하려면 Google Play Console로 이동합니다. 이전에 Play Console에 등록하지 않은 경우 등록하라는 메시지가 표시됩니다.

Play Console에 게임 추가

게임을 추가하려면 다음 단계를 따르세요.

  1. Play Console에서 앱을 만들고 게임 앱임을 명시합니다. 자세한 내용은 앱 만들기 및 설정을 참고하세요.

  2. 확장 > Play 게임즈 서비스 > 설정 및 관리 > 구성으로 이동합니다.

  3. 게임에서 이미 Firebase와 같은 Google API를 사용하는지를 지정합니다. 올바른 옵션을 선택하는 것이 중요합니다. 그러지 않으면 게임에서 Google API를 사용할 때 문제가 발생할 수 있습니다. 옵션은 다음과 같습니다.

    • 아니요. 게임에서 Google API를 사용하지 않습니다: 새 게임을 만들거나 게임에 Google API를 설정한 적이 없는 경우 이 옵션을 선택합니다. 게임 이름을 입력한 후 만들기를 클릭합니다.

    • 예, 게임에서 이미 Google API를 사용합니다: 이미 게임에 Google API를 설정한 경우 이 옵션을 선택합니다. 이 경우 Google Cloud 콘솔에서 프로젝트 목록을 확인할 수 있습니다. 그 목록에서 프로젝트를 선택한 다음 사용을 클릭합니다.

    • 기존 Play 게임즈 서비스 프로젝트를 사용합니다: 기존 Play 게임즈 서비스 프로젝트를 사용하려면 이 옵션을 선택합니다. 계정의 기존 Play 게임즈 서비스 프로젝트 목록이 표시됩니다. 목록에서 게임 프로젝트를 선택한 다음 사용을 클릭합니다. 이 옵션은 일반적인 선택은 아닙니다. 하지만 패키지 이름을 변경하기 위해 Play Console에서 새 게임을 만들거나 다른 패키지 이름의 무료 또는 유료 버전의 게임이 있는 경우 이 옵션을 선택할 수 있습니다.

    Play 게임즈 서비스의 게임 프로젝트가 생성되고, 관련 항목이 Google Cloud 콘솔에 자동으로 생성됩니다.

  4. 속성 섹션에서 속성 수정을 클릭하여 게임의 설명, 카테고리 및 그래픽 저작물과 같은 정보를 추가합니다. 다음은 속성을 구성하기 위한 몇 가지 가이드라인입니다.

OAuth 2.0 클라이언트 ID 생성

Google Play 게임즈 서비스를 호출하도록 인증과 승인을 받으려면 게임에 OAuth 2.0 클라이언트 ID가 있어야 합니다. 클라이언트 ID와 게임 간의 연결인 Play 게임즈 서비스의 사용자 인증 정보를 설정하려면 Google Cloud Platform을 사용하여 클라이언트 ID를 만듭니다. 그런 다음 Google Play Console을 사용하여 사용자 인증 정보를 추가하고 클라이언트 ID를 게임에 연결합니다.

자세한 안내는 다음 단계를 참고하세요.

OAuth 동의 화면을 아직 구성하지 않은 경우 사용자 인증 정보 섹션에 이를 구성하라는 메시지가 표시됩니다.

OAuth 동의 화면을 구성하라는 메시지

구성을 클릭합니다. 그러면 추가 안내와 Google Cloud Platform의 딥 링크가 포함된 대화상자가 열립니다.

OAuth 동의 화면 구성 방법

동의 화면은 게임을 이용할 수 있는 모든 사람에게 제공되어야 합니다. 범위의 최종 목록에는 games, games_lite, drive.appdata가 포함되어야 합니다. 이러한 범위에서는 앱 인증이 필요하지 않습니다. 동의 화면은 즉시 게시하는 것이 좋습니다. 그럴 수 없다면 게임에 로그인할 수 있도록 테스터에게 동의 화면을 제공하면 됩니다.

OAuth 동의 화면 설정을 완료하면 완료를 클릭합니다. Google Play Console이 자동으로 새로고침되며 제대로 구성된 경우 사용자 인증 정보를 만들 수 있습니다.

사용자 인증 정보 만들기

사용자 인증 정보 만들기

게임이 Google Play 게임즈 서비스와 통신하도록 승인하려면 승인된 OAuth2 클라이언트 ID로 사용자 인증 정보를 만들어야 합니다.

사용자 인증 정보 섹션에서 사용자 인증 정보 추가를 클릭합니다.

마법사에서 Android 사용자 인증 정보(게임 APK가 사용자를 인증하고 Play 게임즈 서비스 API를 사용하는 경우)를 만들지, 아니면 게임 서버 사용자 인증 정보(게임 서버가 Play 게임즈 서비스 API를 사용하는 경우)를 만들지 선택합니다. 원하는 사용자 인증 정보 유형에 맞는 안내를 따릅니다.

Android

사용자 인증 정보 세부정보 설정하기

이름 필드의 이름이 게임의 이름과 일치하는지 확인합니다. 불법 복제 방지 사용 여부를 선택합니다.

승인 설정하기

그다음으로 이 게임 프로젝트에 사용할 OAuth 클라이언트 ID를 선택합니다. OAuth2 클라이언트 ID가 이미 있다면 하나를 선택하면 됩니다. 하지만 새로 만드는 것이 보통입니다. OAuth 클라이언트 만들기를 클릭합니다. 그러면 Google Cloud Platform에서 OAuth 클라이언트 ID를 만들기 위한 딥 링크 및 안내가 포함된 대화상자가 열립니다.

  1. 애플리케이션 유형으로 Android를 선택합니다.
  2. 이름 필드에 게임 이름을 입력합니다.
  3. 패키지 이름 필드에 Android 애플리케이션의 패키지 이름을 입력합니다.

  4. 터미널을 열고 Keytool 유틸리티를 실행하여 출시 인증서와 디버그 인증서의 SHA1 지문을 가져옵니다.

    출시 인증서 지문을 가져오려면 다음 명령어를 실행합니다.

    keytool -list -keystore <path-to-production-keystore> -v

    디버그 인증서 지문을 가져오려면 다음 명령어를 실행합니다.

    keytool -list -keystore <path-to-debug-keystore> -v 참고: Windows에서 디버그 키 저장소는 C:\Users\<USERNAME>\.android\debug.keystore에 있습니다. Mac 또는 Linux에서는 디버그 키 저장소는 일반적으로 ~/.android/debug.keystore에 있습니다.

  5. 선택사항: Unity Hub를 사용하여 새 키 저장소를 만들었다면 이전 단계의 안내에 따라 새 인증서를 만들지 마세요. Unity에서 만든 SHA1 디지털 지문을 사용합니다.

    • 다음 명령어를 사용하여 SHA1 지문을 터미널에 출력합니다.

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

  6. keytool 유틸리티에서 키 저장소의 암호를 입력하라는 메시지를 표시합니다. 그러면 keytool이 터미널에 지문을 출력합니다.

  7. 서명 인증서 지문(SHA1) 필드에 SHA1 지문을 붙여넣습니다.

  8. 만들기를 클릭합니다.

Android의 OAuth 2.0에 관한 자세한 내용은 OAuth2 서비스 인증을 참고하세요.

대화상자에서 완료를 클릭하면 사용 가능한 클라이언트 ID가 새로고침됩니다. 드롭다운 메뉴에서 만든 사용자 인증 정보를 선택한 다음 변경사항 저장을 클릭합니다. 그렇게 하면 초안 형태의 사용자 인증 정보가 생성되어 게임에서 Play 게임즈 서비스를 인증할 수 있습니다.

두 개의 사용자 인증 정보를 만들 수 있습니다. 하나는 출시 인증서 지문이 있는 사용자 인증 정보이고, 다른 하나는 디버그 인증서 지문이 있는 사용자 인증 정보입니다. 두 가지 모두에 동일한 패키지 이름을 사용해야 합니다. 그러면 Google Play 게임즈 서비스가 연결된 APK로부터의 호출 중에서 두 인증서 중 하나로 서명된 호출을 인식할 수 있습니다. Android용 인증서 서명에 관한 자세한 내용은 앱 서명을 참고하세요.

게임 서버

사용자 인증 정보 세부정보 설정하기

이름 필드의 이름이 게임의 이름과 일치하는지 확인합니다.

승인 설정하기

그다음으로 이 게임 프로젝트에 사용할 OAuth 클라이언트 ID를 선택합니다. OAuth2 클라이언트 ID가 이미 있다면 하나를 선택하면 됩니다. 하지만 새로 만드는 것이 보통입니다. OAuth 클라이언트 만들기를 클릭합니다. 그러면 Google Cloud Platform에서 OAuth 클라이언트 ID를 만들기 위한 딥 링크 및 안내가 포함된 대화상자가 열립니다.

  1. 애플리케이션 유형으로 웹 애플리케이션을 선택합니다.
  2. 이름 필드에 게임 이름을 입력합니다.
  3. 만들기를 클릭합니다.

Android의 OAuth 2.0에 관한 자세한 내용은 OAuth2 서비스 인증을 참고하세요.

대화상자에서 완료를 클릭하면 사용 가능한 클라이언트 ID가 새로고침됩니다. 드롭다운 메뉴에서 만든 사용자 인증 정보를 선택한 다음 변경사항 저장을 클릭합니다. 그렇게 하면 초안 형태의 사용자 인증 정보가 생성되어 게임에서 Play 게임즈 서비스를 인증할 수 있습니다. 게임 서버에서 Play 게임즈 서비스를 사용하는 방법에 관한 자세한 내용은 Google Play 게임즈 서비스에 서버 측 액세스 사용 설정을 참고하세요.

테스트 사용 설정

Google Play 게임즈 서비스가 게임에서 올바르게 작동하는지 확인하려면 게임 변경사항을 Google Play에 게시하기 전에 게임 서비스를 테스트해야 합니다.

게임이 게시 취소된 상태인 경우 허용 목록에 사용자 계정을 추가하여 테스터에 액세스 권한을 부여합니다. 그러지 않으면 테스터가 로그인 엔드포인트와 같은 Play 게임즈 서비스 엔드포인트에 액세스하려고 할 때 OAuth 오류 및 404 오류가 발생합니다.

승인된 테스트 계정을 보유한 사용자는 게시 취소된 Play 게임즈 서비스의 게임 프로젝트에 액세스할 수 있으며, 구성된 Play 게임즈 서비스가 올바르게 작동하는지 테스트할 수 있습니다.

테스터가 게임에 Play 게임즈 서비스 API를 사용할 수 있도록 하는 방법에는 두 가지가 있습니다.

  • 개별 수준에서 개별 이메일 주소를 추가하는 방법

  • 그룹 수준에서 Play Console 출시 트랙에 Play 게임즈 서비스를 사용 설정하는 방법

게임 프로젝트에 개별 테스터를 추가하려면 다음 단계를 따르세요.

  1. Google Play Console에서 게임의 테스터 탭을 엽니다(확장 > Play 게임즈 서비스 > 설정 및 관리 > 테스터).
  2. 테스터 추가 버튼을 클릭합니다.
  3. 대화상자가 표시되면 테스터로 추가할 Google 계정의 이메일 주소를 입력합니다(쉼표로 구분하거나 한 줄에 이메일 주소를 하나씩 입력하여 구분).
  4. 추가를 클릭하여 사용자를 테스터로 저장합니다. 추가한 테스터 계정은 2시간 이내에 Play 게임즈 서비스에 액세스할 수 있습니다.

그룹에 테스트 권한을 부여하려면 Play 게임즈 서비스에 액세스하도록 출시 트랙을 사용 설정합니다.

Google Play에서는 출시 트랙 기능을 사용하여 앱의 출시 전 버전을 신뢰할 수 있는 사용자로 구성된 통제 그룹에 쉽게 배포할 수 있습니다. Google Play 도움말 웹사이트에서 공개, 비공개, 내부 테스트 설정을 참고하세요.

지정된 출시 트랙에서 테스트 APK에 액세스할 수 있는 모든 사용자에게 게임 테스트 권한을 부여할 수 있습니다. 테스터 목록에 사용자를 개별적으로 추가할 때의 방식으로 동일하게 작동합니다. 이를 위해서는 다음 단계를 따르세요.

  1. PGS 테스터 섹션(확장 > Play 게임즈 서비스 > 설정 및 관리 > 테스터)을 열고 출시 트랙 탭을 선택합니다. 이 페이지에는 Play 게임즈 서비스 테스트에 이미 사용 설정된 트랙 목록도 표시됩니다.
  2. 트랙 추가를 클릭합니다.
  3. Play 게임즈 서비스 테스트에 사용 설정할 트랙을 하나 이상 선택합니다.
  4. 트랙 추가를 클릭합니다.

선택한 출시 트랙이 이제 Play 게임즈 서비스 테스트에 사용 설정된 트랙 목록에 표시됩니다.

이 기능은 Google Play Console에서 Android 앱이 게임에 연결된 경우에만 사용할 수 있습니다.

피해야 할 사항: 일반적인 문제

일반적인 설정 실수를 방지하려면 Google Play 게임즈 서비스를 사용하도록 게임을 설정할 때 다음 권장사항을 따르세요.

1. Play Console로 게임 설정하기
Google Cloud 콘솔에서 앱의 Oauth 2.0 클라이언트 ID를 생성하면 Google Play 게임즈 서비스는 게임의 업적과 리더보드 그리고 클라이언트 ID 간의 연결을 인식하지 못합니다. 이 연결을 생성하려면 사용자 인증 정보 만들기에 설명된 대로 Oauth 2.0 클라이언트 ID를 사용하여 사용자 인증 정보를 만들어야 합니다.
2. Android에서 올바른 애플리케이션 ID 사용하기
애플리케이션 ID는 Android 매니페스트에서 참조해야 하는 필수 문자열 리소스입니다. 애플리케이션 ID 문자열은 Play Console에서 제공되는 클라이언트 ID의 시작 부분에서 숫자(일반적으로 12개 이상)로만 구성되어 있습니다. 애플리케이션 ID는 구성 페이지 상단에서 찾을 수 있으며 게임 이름 아래에 프로젝트 ID로 라벨이 지정되어 있습니다.
3. 올바른 인증서로 APK에 서명하기
Play Console에서 게임에 Android 앱을 연결할 경우, 앱을 게시하는 데 사용한 것과 정확히 동일한 패키지 이름과 인증서 지문을 사용해야 합니다. 일치하지 않는 경우 Google Play 게임즈 서비스 호출이 실패합니다. 클라이언트 ID를 두 개 만들어야 합니다. 하나는 출시 인증서 지문이 있는 클라이언트 ID이고, 다른 하나는 디버그 인증서 지문이 있는 클라이언트 ID입니다. 이 두 항목에 모두 동일한 패키지 이름을 사용해야 합니다. Play Console에서 서명 인증서를 지정하는 방법을 자세히 알아보려면 애플리케이션 서명을 참고하세요.
4. Android용으로 개발할 때 Play 게임즈 SDK를 독립형 JAR이 아닌 라이브러리 프로젝트로 포함합니다.
Android 프로젝트에서 Google Play 서비스 SDK가 라이브러리 프로젝트로 참조되어야 합니다. 그러지 않으면 앱에서 Google Play 서비스 리소스를 찾을 수 없을 때 오류가 발생할 수 있습니다. Google Play 서비스를 사용하도록 Android 프로젝트를 설정하는 방법을 알아보려면 Google Play 서비스 설정을 참고하세요.
5. 개발 중에 테스터 계정으로 로그인
Play Console에 게임 설정 변경사항을 게시하지 않은 경우 허용된 테스터 계정으로 로그인하지 않으면 테스트 중에 오류가 발생할 수 있습니다. 테스트하려면 항상 Play Console 게시자 계정을 사용 설정해야 합니다. 테스터 계정을 관리하는 방법을 알아보려면 테스트용 계정 사용 설정을 참고하세요.
6. Google Cloud Platform에 동의 화면 게시하기
앱을 Play Console에 게시하기 전에 Google Cloud Platform에 동의 화면을 게시합니다. 이 단계 없이는 일반 사용자가 Play 게임즈 서비스 기능을 전혀 사용할 수 없습니다.
7. 출시 시점에서 게임을 게시하기 전에 Play 게임즈 서비스 설정을 먼저 게시합니다.
개발자는 앱의 관련 Play 게임즈 서비스 설정을 게시하지 않고 실수로 앱을 게시할 수도 있습니다. 이 경우 앱에서 올바른 게임 설정을 참조할 수 없으므로, 테스터가 아닌 다른 계정으로 로그인한 플레이어는 오류를 겪을 수 있습니다. 게임을 출시할 때 Play Console의 게임 게시 옵션을 사용하여 게임 설정을 먼저 게시해야 합니다. 변경사항을 게시하는 방법을 알아보려면 게임 변경사항 게시를 참고하세요.

추가 도움말은 Android 문제 해결 가이드를 참고하세요.

다음 단계

위에 설명된 초기 설정 작업을 완료하고 나면 저장된 게임, 리더보드, 업적 같은 Play 게임즈 서비스 기능을 앱에 사용 설정할 수 있습니다.