Memulai Layanan game Play untuk Android

Perhatian: Panduan ini ditujukan untuk menggunakan SDK Layanan game Play v1. Sebagai informasi SDK terbaru, lihat dokumentasi Layanan game Play v2.

Selamat datang di pengembangan game Android dengan layanan game Google Play!

SDK Play Game menyediakan layanan game Google Play lintas platform yang memudahkan Anda mengintegrasikan fitur game populer, seperti pencapaian, papan peringkat, dan Game Tersimpan di game tablet dan seluler Anda.

Pelatihan ini akan memandu Anda menginstal aplikasi game contoh untuk Android dan mulai membuat game Android Anda sendiri dengan cepat. Type-a-Number Contoh aplikasi tantangan menunjukkan bagaimana Anda dapat mengintegrasikan pencapaian dan papan peringkat ke dalam game.

Sebelum memulai

Untuk mempersiapkan aplikasi Anda, selesaikan langkah-langkah di bagian berikut ini.

Prasyarat aplikasi

Pastikan bahwa file build aplikasi Anda menggunakan nilai berikut:

• minSdkVersion dari 19 yang lebih tinggi
• compileSdkVersion dari 28 atau yang lebih tinggi

Menyiapkan game Anda di Konsol Google Play

Konsol Google Play adalah tempat Anda mengelola layanan game Google Play untuk game, dan mengonfigurasi metadata untuk memberikan otorisasi dan mengautentikasi game. Untuk informasi selengkapnya, lihat Menyiapkan Layanan game Google Play.

Mengonfigurasi aplikasi Anda

Dalam file build.gradle level project, sertakan Repositori Maven Google dan Repositori pusat Maven di bagian buildscript dan allprojects:

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

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

Tambahkan dependensi layanan Google Play untuk SDK Play Game ke file build Gradle modul, yang biasanya app/build.gradle:

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

Panduan Aplikasi Contoh

Pelatihan ini akan memandu Anda menginstal aplikasi game contoh untuk Android dan mulai membuat game Android Anda sendiri dengan cepat. Type-a-Number Contoh aplikasi tantangan menunjukkan bagaimana Anda dapat mengintegrasikan pencapaian dan papan peringkat ke dalam game.

Langkah 1: Download aplikasi contoh

Untuk panduan developer ini, Anda perlu mendownload contoh Tantangan Type-a-Number aplikasi Android.

Untuk mendownload dan menyiapkan aplikasi contoh di Android Studio:

1. Download contoh Android dari contoh halaman download.
2. Impor project android-basic-samples. Project ini menyertakan TypeANumber dan game Android lainnya sampel. Untuk melakukannya di Android Studio:
   1. Klik File > Impor Project.
   2. Buka direktori tempat Anda mendownload android-basic-samples pada pengembangan Anda mesin Linux dan Windows. Pilih file android-basic-samples/build.gradle, lalu klik OK.
3. Dalam modul TypeANumber, buka AndroidManifest.xml dan ubah nama paket dari com.google.example.games.tanc ke nama paket yang berbeda. Nama paket baru harus tidak diawali dengan com.google, com.example, atau com.android.

Langkah 2: Siapkan game di Konsol Google Play

Konsol Google Play adalah tempat Anda mengelola layanan game Google Play untuk game Anda, dan mengonfigurasi metadata untuk memberi otorisasi dan mengautentikasi game.

Untuk menyiapkan contoh game di Konsol Google Play:

1. Arahkan browser web Anda ke Konsol Google Play, dan login. Jika belum pernah mendaftar ke Konsol Google Play, Anda akan diminta untuk melakukannya.
2. Ikuti petunjuk berikut untuk menambahkan game ke Konsol Google Play.
   1. Saat ditanya apakah Anda menggunakan Google API di aplikasi Anda, pilih Saya belum menggunakan Google API apa pun dalam game saya.
   2. Untuk tujuan panduan developer ini, Anda dapat mengisi formulir dengan detail game. Untuk memudahkan, Anda dapat menggunakan ikon placeholder dan screenshot yang disediakan di halaman Download.
3. Ikuti petunjuk berikut untuk membuat client ID OAuth 2.0 untuk aplikasi Android Anda.
   1. Saat menautkan aplikasi Android, pastikan untuk menentukan paket yang tepat nama yang Anda gunakan sebelumnya saat mengganti nama paket sampel.
   2. Anda dapat menggunakan Wizard Membuat APK Bertanda Tangan di Android Studio untuk membuat keystore baru dan sertifikat yang ditandatangani jika Anda belum memilikinya. Untuk mempelajari cara jalankan Wizard Buat APK Bertanda Tangan, lihat Menandatangani Aplikasi di Android Studio.
4. Pastikan untuk mencatat informasi berikut untuk digunakan nanti:
   1. ID aplikasi Anda: Ini adalah string yang hanya terdiri dari digit (biasanya 12 digit atau lebih), di awal client ID.
   2. Sertifikat penandatanganan Anda: Catat sertifikat yang Anda gunakan saat menyiapkan akses API Anda (sertifikat yang sidik jari SHA1-nya Anda berikan). Anda harus menggunakan sertifikat yang sama untuk menandatangani aplikasi saat menguji atau merilis .
5. Konfigurasi pencapaian untuk Type-a-Number Challenge:
   1. Pilih tab Pencapaian di Konsol Google Play.
   2. Tambahkan contoh pencapaian berikut:

      Nama	Deskripsi	Petunjuk Khusus
      Tanda petik	Mendapatkan skor yang berupa bilangan prima.	None
      Humble	Meminta skor 0.	None
      Jangan sombong, nak	Meminta skor 9999 dalam mode mana pun.	None
      Astaga KAMU TIDAK ADA!	Menerima skor 1337.	Jadikan ini pencapaian tersembunyi.
      Bosan	Memainkan game 10 kali.	Jadikan ini sebagai pencapaian tambahan dengan 10 langkah untuk membukanya.
      Sangat Bosan	Memainkan game 100 kali.	Jadikan ini sebagai pencapaian tambahan dengan 100 langkah untuk dibuka.

   3. Catat ID (string alfanumerik panjang) untuk setiap pencapaian yang dibuat.
   4. Konfigurasi pencapaian yang sesuai untuk game Anda. Untuk mempelajari lebih lanjut, lihat konsep di balik pencapaian dan cara menerapkan pencapaian di Android.
6. Konfigurasi papan peringkat untuk Type-a-Number Challenge:
   1. Pilih tab Papan peringkat di Konsol Google Play.
   2. Tambahkan dua contoh papan peringkat: satu bernama “Skor Tinggi Mudah” dan satu lagi yang bernama “Skor Tinggi Sulit”. Kedua papan peringkat harus menggunakan pemformatan skor Bilangan Bulat dengan 0 angka desimal, dan jenis pengurutan Lebih besar lebih baik.
   3. Catat ID (string alfanumerik panjang) untuk setiap papan peringkat yang Anda buat.
   4. Konfigurasi papan peringkat yang sesuai untuk game Anda. Untuk mempelajari lebih lanjut, melihat konsep di balik papan peringkat dan cara menerapkan papan peringkat di Android.
7. Tambahkan akun pengujian untuk game Anda. Langkah ini hanya diperlukan untuk aplikasi yang belum dipublikasikan di Konsol Google Play. Sebelum aplikasi dipublikasikan, hanya akun pengujian yang tercantum di Konsol Google Play dapat login. Namun, setelah aplikasi dipublikasikan, setiap orang diizinkan untuk {i>login<i}.

Peringatan: Jika Anda mencoba melakukan panggilan SDK Play Game untuk game yang tidak dipublikasikan dengan menggunakan akun yang tidak tercantum sebagai akun pengujian, layanan game Google Play akan berperilaku sebagai jika game tidak ada dan Anda akan mendapatkan kembali ConnectionResult.SIGN_IN_REQUIRED kode pengembalian. Jika Anda mencoba meluncurkan ConnectionResult.startResolutionForResult(), kamu akan mendapatkannya kembali GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Langkah 3: Ubah kode

Untuk menjalankan game, Anda harus mengonfigurasi ID aplikasi sebagai resource di Project Android. Anda juga perlu menambahkan metadata game di AndroidManifest.xml.

1. Buka res/values/ids.xml dan ganti ID placeholder. Jika Anda membuat game Android dari awal, Anda harus membuat file ini terlebih dahulu.
   1. Tentukan ID aplikasi Anda di resource app_id.
   2. Sebutkan setiap ID pencapaian yang Anda buat sebelumnya di kolom Resource achievement_*.
   3. Tentukan setiap ID papan peringkat yang Anda buat sebelumnya pada Resource leaderboard_*.
2. Buka AndroidManifest.xml dan masukkan nama paket Anda di package <manifest> . Jika Anda membuat game Android dari awal, pastikan Anda juga menambahkan kode berikut di dalam <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"/>
   

Langkah 4: Uji game Anda

Untuk memastikan bahwa layanan game Google Play berfungsi dengan baik dalam game Anda, uji aplikasi sebelum memublikasikannya di Google Play.

Catatan: Sebaiknya Anda menjalankan pengujian di perangkat Android fisik. Namun, jika Anda tidak memiliki perangkat fisik, Anda dapat mengujinya dengan Android Emulator. Untuk melakukannya, download image sistem emulator yang menyertakan Layanan Google Play, pada Android 4.2.2, dari SDK Manager.

Untuk menjalankan game di perangkat pengujian fisik:

1. Pastikan Anda telah menyiapkan akun pengujian yang digunakan untuk login ke aplikasi (seperti yang dijelaskan di Langkah 2).
2. Ekspor APK dan tanda tangani dengan sertifikat yang sama dengan yang Anda gunakan untuk menyiapkan project di Konsol Google Play. Untuk mengekspor APK yang ditandatangani di Android Studio, klik Bangun > Buat APK Bertanda Tangan.
3. Instal APK yang ditandatangani di perangkat pengujian fisik menggunakan alat adb. Untuk mempelajari cara menginstal aplikasi, lihat Berjalan di Perangkat.

Peringatan: Jika Anda menjalankan aplikasi langsung dari Android Studio, Android Studio akan menandatangani aplikasi dengan sertifikat debug Anda secara {i>default<i}. Jika Anda tidak menggunakan sertifikat debug saat menyiapkan aplikasi di Konsol Google Play, akan menyebabkan error. Pastikan untuk menjalankan APK yang telah Anda ekspor dan tanda tangani dengan sertifikat yang cocok dengan salah satu sertifikat yang Anda gunakan selama aplikasi penyiapan di Konsol Google Play.