이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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 중앙 저장소를 buildscript 및 allprojects 섹션에 포함합니다.

  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.1.0'
  }

샘플 앱 가이드

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

1단계: 샘플 앱 다운로드

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

Android 스튜디오에서 샘플 애플리케이션을 다운로드하고 설정하려면 다음 단계를 따르세요.

샘플 다운로드 페이지에서 Android 샘플을 다운로드합니다.
android-basic-samples 프로젝트를 가져옵니다. 이 프로젝트에는 TypeANumber 및 기타 Android 게임 샘플이 포함되어 있습니다. Android 스튜디오에서 이 작업을 실행하려면 다음 단계를 따르세요.
1. File > Import Project를 클릭합니다.
2. 개발 머신에서 android-basic-samples를 다운로드한 디렉터리로 이동합니다. android-basic-samples/build.gradle 파일을 선택하고 OK를 클릭합니다.
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에서 샘플 게임을 설정하려면 다음 단계를 따르세요.

웹브라우저에서 Google Play Console로 이동하고 로그인합니다. 이전에 Google Play Console에 등록하지 않은 경우 등록하라는 메시지가 표시됩니다.
다음 안내에 따라 Google Play Console에 게임을 추가합니다.
1. 앱에서 Google API 사용 여부를 묻는 질문이 표시되면 아직 게임에서 Google API를 사용하지 않습니다를 선택합니다.
2. 이 개발자 가이드에서는 자체 게임 세부정보로 양식을 작성할 수 있습니다. 편의상 다운로드 페이지에서 제공되는 자리표시자 아이콘과 스크린샷을 사용할 수 있습니다.
다음 안내에 따라 Android 앱의 OAuth 2.0 클라이언트 ID를 생성합니다.
1. Android 앱을 연결할 때는 이전에 샘플 패키지 이름을 변경할 때 사용한 패키지 이름을 정확하게 지정해야 합니다.
2. 키 저장소와 서명된 인증서가 아직 없는 경우 Android 스튜디오에서 Generate Signed APK Wizard를 사용하여 새 키 저장소와 서명된 인증서를 생성할 수 있습니다. Generate Signed APK Wizard를 실행하는 방법을 알아보려면 Android 스튜디오에서 앱 서명을 참고하세요.
나중을 위해 다음 정보를 기록해 둡니다.
1. 애플리케이션 ID: 숫자로만 구성된 문자열 (일반적으로 12 이상)이며 클라이언트 ID의 첫 부분입니다.
2. 서명 인증서: API 액세스를 설정할 때 사용한 인증서 (SHA1 디지털 지문을 제공한 인증서)를 기록합니다. 앱을 테스트하거나 출시할 때 동일한 인증서를 사용하여 앱에 서명해야 합니다.

Type-a-Number Challenge의 업적을 구성합니다.

Google Play Console에서 업적 탭을 선택합니다.

다음 샘플 업적을 추가합니다.

이름	설명	주의 사항
프라임	소수인 점수를 가져옵니다.	None
Humble	점수 0을 요청합니다.	None
자꾸 꾸미지 마	어느 모드에서든 9,999점을 요청합니다.	None
어머, 잘 하셨어요!	점수 1337을 수신합니다.	숨겨진 업적으로 만듭니다.
지루함	게임을 10회 플레이합니다.	달성까지 10단계가 있는 단계별 업적으로 만듭니다.
정말 지루함	게임을 100회 플레이합니다.	달성까지 100단계가 있는 단계별 업적으로 만듭니다.

생성한 각 업적의 ID (긴 영숫자 문자열)를 기록해 둡니다.
게임에 적합한 업적을 구성합니다. 자세한 내용은 업적의 개념과 Android에서 업적을 구현하는 방법을 참고하세요.

Type-a-Number Challenge의 리더보드를 구성합니다.
1. Google Play Console에서 리더보드 탭을 선택합니다.
2. 'Easy High Scores'와 'Hard High Scores'라는 이름의 샘플 리더보드 두 개를 추가합니다. 두 리더보드 모두 소수점이 없는 정수의 점수 형식을 사용해야 하며 점수가 높을수록 좋음 유형의 순서로 정렬되어야 합니다.
3. 생성한 각 리더보드의 ID (긴 영숫자 문자열)를 기록합니다.
4. 게임에 적합한 리더보드를 구성합니다. 자세한 내용은 리더보드의 개념과 Android에서 리더보드를 구현하는 방법을 참고하세요.
게임의 테스트 계정을 추가합니다. 이 단계는 Google Play Console에 아직 게시되지 않은 앱에만 필요합니다. 앱을 게시하기 전에는 Google Play Console에 나열된 테스트 계정만 로그인할 수 있습니다. 하지만 애플리케이션이 게시된 후에는 누구나 로그인할 수 있습니다.

3단계: 코드 수정

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

res/values/ids.xml를 열고 자리표시자 ID를 교체합니다. 처음부터 Android 게임을 만드는 경우 먼저 이 파일을 만들어야 합니다.
1. app_id 리소스에 애플리케이션 ID를 지정합니다.
2. 이전에 만든 각 업적 ID를 상응하는 achievement_* 리소스에 지정합니다.
3. 이전에 만든 리더보드 ID를 상응하는 leaderboard_* 리소스에 지정합니다.
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에 게시하기 전에 애플리케이션을 테스트하세요.

실제 테스트 기기에서 게임을 실행하려면 다음 단계를 따르세요.

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