Halaman ini diterjemahkan oleh Cloud Translation API.

Memulai Layanan game Play untuk Android

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

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

Pelatihan ini akan memandu Anda menginstal contoh aplikasi game untuk Android dan mulai membuat game Android Anda sendiri dengan cepat. Aplikasi contoh Type-a-Number Challenge menunjukkan cara 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 Play Game SDK ke file build Gradle modul Anda, yang biasanya app/build.gradle:

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

Contoh Panduan Aplikasi

Langkah 1: Download aplikasi contoh

Untuk panduan developer ini, Anda perlu mendownload contoh aplikasi Android Challenge Jenis-Angka.

Untuk mendownload dan menyiapkan aplikasi contoh di Android Studio:

Download contoh Android dari halaman download contoh.
Impor project android-basic-samples. Project ini mencakup TypeANumber dan contoh game Android lainnya. Untuk melakukannya di Android Studio:
1. Klik File > Impor Project.
2. Buka direktori tempat Anda mendownload android-basic-samples di mesin pengembangan. Pilih file android-basic-samples/build.gradle, lalu klik OK.
Dalam modul TypeANumber, buka AndroidManifest.xml dan ubah nama paket dari com.google.example.games.tanc menjadi nama paket Anda sendiri. Nama paket baru tidak boleh 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, dan mengonfigurasi metadata untuk memberikan otorisasi dan mengautentikasi game.

Untuk menyiapkan contoh game di Konsol Google Play:

Arahkan browser web Anda ke Konsol Google Play, lalu login. Jika belum pernah mendaftar ke Konsol Google Play, Anda akan diminta untuk melakukannya.
Ikuti petunjuk ini 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 di game saya.
2. Untuk tujuan panduan developer ini, Anda dapat mengisi formulir dengan detail game Anda sendiri. Untuk memudahkan, Anda dapat menggunakan ikon placeholder dan screenshot yang disediakan di halaman Download.
Ikuti petunjuk ini untuk membuat client ID OAuth 2.0 untuk aplikasi Android Anda.
1. Saat menautkan aplikasi Android, pastikan untuk menentukan nama paket yang sama persis dengan yang Anda gunakan sebelumnya saat mengganti nama paket contoh.
2. Anda dapat menggunakan Wizard Membuat APK Bertanda Tangan di Android Studio untuk membuat keystore dan sertifikat baru yang ditandatangani jika belum memilikinya. Untuk mempelajari cara menjalankan Wizard Generate Signed APK, lihat Menandatangani Aplikasi di Android Studio.
Pastikan untuk mencatat informasi berikut untuk digunakan nanti:
1. ID aplikasi: Ini adalah string yang hanya terdiri dari angka (biasanya 12 digit atau lebih), di awal client ID Anda.
2. Sertifikat penandatanganan: Perhatikan sertifikat yang Anda gunakan saat menyiapkan akses API (sertifikat yang sidik jari SHA1 Anda berikan). Anda harus menggunakan sertifikat yang sama untuk menandatangani aplikasi saat menguji atau merilis aplikasi.

Konfigurasikan pencapaian untuk Tantangan Ketik Angka:

Pilih tab Pencapaian di Konsol Google Play.

Tambahkan contoh pencapaian berikut:

Nama	Deskripsi	Petunjuk Khusus
Prime	Dapatkan skor yang berupa bilangan prima.	None
Humble	Minta skor 0.	None
Jangan sombong, nak	Minta skor 9999 dalam mode mana pun.	None
OMG U R TEH UBER LEET!	Menerima skor 1337.	Jadikan ini pencapaian tersembunyi.
Bosan	Memainkan game 10 kali.	Jadikan ini sebagai pencapaian inkremental dengan 10 langkah untuk membuka.
Amat Sangat Bosan	Memainkan game 100 kali.	Jadikan ini sebagai pencapaian inkremental dengan 100 langkah untuk membuka kunci.

Catat ID (string alfanumerik panjang) untuk setiap pencapaian yang Anda buat.
Konfigurasikan pencapaian yang sesuai untuk game Anda. Untuk mempelajari lebih lanjut, lihat konsep di balik pencapaian dan cara menerapkan pencapaian di Android.

Konfigurasikan papan peringkat untuk Tantangan Ketik Angka:
1. Pilih tab Papan Peringkat di Konsol Google Play.
2. Tambahkan dua contoh papan peringkat: satu bernama "Skor Tinggi Mudah" dan satu lagi bernama "Skor Tinggi Sulit". Kedua papan peringkat harus menggunakan pemformatan skor Bilangan Bulat dengan 0 angka di belakang koma, 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, lihat konsep di balik papan peringkat dan cara menerapkan papan peringkat di Android.
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 yang dapat login. Namun, setelah aplikasi dipublikasikan, semua orang diizinkan untuk login.

Langkah 3: Ubah kode Anda

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

Buka res/values/ids.xml dan ganti ID placeholder. Jika membuat game Android dari awal, Anda perlu membuat file ini terlebih dahulu.
1. Tentukan ID aplikasi Anda di resource app_id.
2. Tentukan setiap ID pencapaian yang Anda buat sebelumnya dalam resource achievement_* yang sesuai.
3. Tentukan setiap ID papan peringkat yang Anda buat sebelumnya dalam resource leaderboard_* yang sesuai.

Buka AndroidManifest.xml dan masukkan nama paket Anda di atribut package dari elemen <manifest>. Jika Anda membuat game Android dari awal, pastikan Anda juga menambahkan kode berikut di dalam elemen <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, uji aplikasi sebelum memublikasikannya di Google Play.

Untuk menjalankan game Anda di perangkat pengujian fisik:

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