Android용 Play 게임즈 서비스 시작하기

Google Play 게임즈 서비스를 활용하여 Android 게임을 개발해 주셔서 감사합니다.

Play 게임즈 SDK는 업적, 리더보드, 저장된 게임과 같은 인기 게임 기능을 태블릿 및 모바일 게임에 쉽게 통합할 수 있는 크로스 플랫폼 Google Play 게임즈 서비스를 제공합니다.

이 교육 과정에서는 Android용 샘플 게임 애플리케이션을 설치하고 나만의 Android용 게임을 빠르게 만드는 방법을 안내합니다. Type-a-Number Challenge 샘플 앱은 업적과 리더보드를 게임에 통합하는 방법을 보여 줍니다.

시작하기 전에

앱을 준비하려면 다음 섹션의 단계를 완료합니다.

앱 기본 요건

앱의 빌드 파일이 다음 값을 사용하는지 확인합니다.

  • minSdkVersion 19 이상
  • compileSdkVersion 28 이상

Google Play Console에서 게임 설정

Google Play Console에서는 게임의 Google Play 게임즈 서비스를 관리하고 게임의 승인과 인증에 필요한 메타데이터를 설정할 수 있습니다. 자세한 내용은 Google Play 게임즈 서비스 설정을 참고하세요.

앱 구성

프로젝트 수준의 build.gradle 파일에서 Google의 Maven 저장소Maven 중앙 저장소buildscriptallprojects 섹션에 포함합니다.

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

모듈의 Gradle 빌드 파일(일반적으로 app/build.gradle임)에 Play 게임즈 SDK의 Google Play 서비스 종속 항목을 추가합니다.

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

샘플 앱 가이드

이 학습 과정에서는 Android용 샘플 게임 앱을 설치하고 나만의 Android 게임을 빠르게 만드는 방법을 안내합니다. Type-a-Number Challenge 샘플 앱은 업적과 리더보드를 게임에 통합하는 방법을 보여 줍니다.

1 단계: 샘플 앱 다운로드

이 개발자 가이드에서는 Type-a-Number Challenge 샘플 Android 애플리케이션을 다운로드해야 합니다.

Android 스튜디오에서 샘플 애플리케이션을 다운로드하고 설정하는 방법은 다음과 같습니다.

  1. 샘플 다운로드 페이지에서 Android 샘플을 다운로드합니다.
  2. android-basic-samples 프로젝트를 가져옵니다. 이 프로젝트에는 TypeANumber 및 기타 Android 게임 샘플이 포함되어 있습니다. Android 스튜디오에서 이 작업을 수행하려면 다음 단계를 따르세요.
    1. File > Import Project를 클릭합니다.
    2. 개발 컴퓨터에서 android-basic-samples를 다운로드한 디렉터리로 이동합니다. android-basic-samples/build.gradle 파일을 선택하고 확인을 클릭합니다.
  3. TypeANumber 모듈에서 AndroidManifest.xml를 열고 패키지 이름을 com.google.example.games.tanc에서 나만의 다른 패키지 이름으로 변경합니다. 새 패키지 이름은 com.google, com.example 또는 com.android로 시작하면 안 됩니다.

2단계: Google Play Console에서 게임 설정하기

Google Play Console에서는 게임의 Google Play 게임즈 서비스를 관리하고 게임의 승인과 인증에 필요한 메타데이터를 설정할 수 있습니다.

Google Play Console에서 샘플 게임을 설정하는 방법은 다음과 같습니다.

  1. 웹브라우저에서 Google Play Console로 이동하고 로그인합니다. 이전에 Google Play Console에 등록하지 않은 경우 등록 안내 메시지가 표시됩니다.
  2. 다음 안내에 따라 Google Play Console에 게임을 추가합니다.
    1. 앱에서 Google API 사용 여부를 묻는 질문이 나타나면 아직 게임에서 Google API를 사용하지 않습니다를 선택합니다.
    2. 이 개발자 가이드의 목적에 따라 나만의 게임 세부정보로 양식을 작성합니다. 필요한 경우 다운로드 페이지에서 제공되는 자리표시자 아이콘과 스크린샷을 사용할 수 있습니다.
  3. 다음 안내에 따라 Android 앱의 OAuth 2.0 클라이언트 ID를 생성합니다.
    1. Android 앱을 연결할 때 이전에 샘플 패키지 이름을 변경할 때 사용한 정확한 패키지 이름을 지정해야 합니다.
    2. 키 저장소와 서명된 인증서가 없을 경우 Android 스튜디오에서 Generate Signed APK Wizard를 사용하여 새 키 저장소와 서명된 인증서를 생성할 수 있습니다 Generate Signed APK Wizard를 실행하는 방법을 알아보려면 Android 스튜디오에서 앱 서명하기를 참조하세요.
  4. 나중에 사용할 수 있도록 다음 정보를 기록해 둡니다.
    1. 애플리케이션 ID: 보통 12자리 이상의 숫자로만 구성된 문자열이며 클라이언트 ID의 첫 부분입니다.
    2. 서명 인증서: API 액세스를 설정할 때 사용한 인증서로, SHA1 지문 파일을 제공한 인증서입니다. 앱을 테스트하거나 출시할 때 앱에 서명하려면 동일한 인증서를 사용해야 합니다.
  5. Type-a-Number Challenge의 업적을 구성합니다.
    1. Google Play Console에서 업적 탭을 선택합니다.
    2. 다음 업적을 추가합니다.
      이름 설명 특별 안내
      Prime 얻은 점수가 소수입니다. 없음
      Humble 점수 0을 요청합니다. 없음
      Don't get cocky, kid 양쪽 모드에서 점수 9999를 요청합니다. 없음
      OMG U R TEH UBER LEET! 점수 1337을 수신합니다. 숨겨진 업적으로 만듭니다.
      Bored 게임을 10번 합니다. 달성까지 10 단계가 있는 단계별 업적으로 만듭니다.
      Really Really Bored 게임을 100번 합니다. 달성까지 100단계가 있는 단계별 업적으로 만듭니다.
    3. 생성한 각 업적의 ID(긴 영숫자 문자열)를 기록해 둡니다.
    4. 게임에 적합한 업적을 설정합니다. 자세한 내용은 업적의 개념Android에서 업적을 구현하는 방법을 참고하세요.
  6. Type-a-Number Challenge의 리더보드를 구성합니다.
    1. Google Play Console에서 리더보드 탭을 선택합니다.
    2. 'Easy High Scores'와 'Hard High Scores'라는 이름의 샘플 리더보드 두 개를 추가합니다. 두 리더보드 모두 소수점이 없는 정수의 점수 형식과 점수가 높을수록 좋음 유형의 순서로 구성되어야 합니다.
    3. 생성한 각 리더보드의 ID(긴 영숫자 문자열)를 기록해 둡니다.
    4. 게임에 적합한 리더보드를 구성합니다. 자세한 내용은 리더보드의 개념Android에서 리더보드를 구현하는 방법을 참고하세요.
  7. 게임의 테스트 계정을 추가합니다. 이 단계는 Google Play Console에 아직 게시되지 않은 앱에만 필요합니다. 앱을 게시하기 전에는 Google Play Console에 나열된 테스트 계정만 로그인할 수 있습니다. 하지만 애플리케이션이 게시된 후에는 누구나 로그인할 수 있습니다.

3단계: 코드 수정하기

게임을 실행하려면 Android 프로젝트에서 애플리케이션 ID를 리소스로 설정해야 합니다. AndroidManifest.xml에 게임 메타데이터도 추가해야 합니다.

  1. res/values/ids.xml를 열고 자리표시자 ID를 교체합니다. 처음부터 Android 게임을 생성하는 경우 먼저 이 파일을 생성해야 합니다.
    1. app_id 리소스에서 애플리케이션 ID를 지정합니다.
    2. 이전에 만들었던 업적 ID를 해당하는 achievement_* 리소스에 지정합니다.
    3. 이전에 만들었던 리더보드 ID를 해당하는 leaderboard_* 리소스에 지정합니다.
  2. AndroidManifest.xml를 열고 <manifest> 요소의 package 속성에 패키지 이름을 입력합니다. Android 게임을 처음부터 생성하는 경우 <application> 요소 내에 다음 코드도 추가해야 합니다.
    <meta-data android:name="com.google.android.gms.games.APP_ID"
        android:value="@string/app_id" />
    <meta-data android:name="com.google.android.gms.version"
       android:value="@integer/google_play_services_version"/>
    

4 단계: 게임 테스트

게임에서 Google Play 게임즈 서비스가 올바르게 작동하는지 확인하려면 Google Play에 게시하기 전에 애플리케이션을 테스트하세요.

실제 테스트 기기에서 게임을 실행하는 방법은 다음과 같습니다.

  1. 2단계에서 설명한 것처럼 앱에 로그인할 때 사용하는 테스트 계정을 설정했는지 확인합니다.
  2. APK를 내보내고 Google Play Console에서 프로젝트를 설정할 때 사용했던 것과 동일한 인증서로 서명합니다. Android 스튜디오에서 서명된 APK를 내보내려면 Build > Generate Signed APK를 클릭합니다.
  3. adb 도구를 사용하여 실제 테스트 기기에 서명된 APK를 설치합니다. 애플리케이션 설치 방법은 기기에서 앱 실행하기를 참고하세요.