Ringkasan migrasi

Google Play Game Services, SDK game v1 mengandalkan Login dengan Google untuk Android yang tidak digunakan lagi dan akan dihapus dari Google Play Services Auth SDK (com.google.android.gms:play-services-auth) pada tahun 2025. Aplikasi game baru dapat menggunakan game v1 hingga tahun 2025. Penghapusan Login dengan Google memunculkan masalah dependensi untuk aplikasi game yang sudah ada. Memigrasikan aplikasi game yang ada dari SDK game v1 ke SDK game v2 akan menyelesaikan masalah dependensi yang disebabkan oleh penghapusan Login dengan Google.

Dokumen ini membantu Anda memahami interaksi antara aplikasi game dan berbagai SDK. Dokumen ini juga membandingkan fitur aplikasi dengan fitur SDK game v1 dan game v2 Layanan game Play.

Interaksi SDK

Diagram ini menggambarkan interaksi antara aplikasi game di Android, GMS Core, Layanan game Play, dan server game pihak ketiga (3P). Bagian ini menjelaskan cara aplikasi menggunakan layanan Google untuk autentikasi dan fitur game, sekaligus berinteraksi dengan sistem pihak ketiga yang terpisah.

games v2 (Saat ini)

Interaksi antara Aplikasi Game di
    Android, GMS Core, Layanan game Play,
    dan server game pihak ketiga (3P).
Interaksi antara Aplikasi Game di Android, GMS Core, Layanan Game Play, dan server game pihak ketiga (3P). (klik untuk memperbesar).

games v1 (Lama)

Interaksi antara Aplikasi Game di
    Android, GMS Core, Layanan game Play,
    dan server game pihak ketiga (3P).
Interaksi antara Aplikasi Game di Android, GMS Core, Layanan Game Play, dan server game pihak ketiga (3P). (klik untuk memperbesar).

Berikut adalah ringkasan singkat komponen dan SDK:

  • Aplikasi Game.
    • Objek ini merepresentasikan aplikasi game pengguna yang berjalan di perangkat berteknologi Android.
    • API ini berisi dua komponen utama:
      • SDK game v1 atau game v2. SDK sisi klien yang bertanggung jawab untuk berinteraksi dengan Layanan game Play.
      • Auth SDK. SDK Auth layanan Google Play bertanggung jawab untuk menangani alur otorisasi dan autentikasi pengguna di game v1.
    • Kedua SDK berkomunikasi menggunakan AIDL (Android Interface Definition Language), yang menunjukkan pola komunikasi antara proses atau layanan yang berbeda.
  • GMS Core juga disebut sebagai Layanan Google Play.
    • Ini adalah lapisan milik Google di Android.
    • Aplikasi game menggunakan dua modul GMS Core:
      • Modul Game. menyediakan fitur khusus game, seperti papan peringkat, pencapaian, dan pengelolaan status game.
      • Auth Module. Menangani operasi otorisasi dan autentikasi pengguna.
    • SDK Game dan Auth di aplikasi game berkomunikasi dengan modul yang sesuai menggunakan antarmuka AIDL, yang menunjukkan komunikasi antar-proses (IPC).

  • Gateway Layanan game Play.
    • Gateway logis yang memediasi komunikasi antara GMS Core dan server Layanan game Play.
    • Menangani permintaan API, transformasi data, dan autentikasi untuk komunikasi server.
  • Server Layanan game Play.
    • Mewakili layanan backend Layanan game Play yang bertanggung jawab untuk menyimpan data game, mengelola akun pengguna, dan memfasilitasi fitur multiplayer.
  • Gateway game pihak ketiga.
    • Jika aplikasi game Anda memenuhi syarat sebagai aplikasi pihak ketiga (3P), library klien berkomunikasi dengan server Layanan game Play melalui server game pihak ketiga.
    • Menyiratkan bahwa aplikasi juga dapat melakukan autentikasi dengan penyedia layanan yang berbeda.
  • Server game pihak ketiga.
    • Mewakili server eksternal opsional yang dapat berinteraksi dengan aplikasi game, kemungkinan untuk fitur kustom atau pengelolaan data.
    • Komunikasi dengan aplikasi terjadi melalui gateway game pihak ketiga.

Perbandingan fitur

Tabel ini memberikan perbandingan fitur antara SDK game v1 dan game v2:


Fitur

SDK game v1

SDK game v2

Autentikasi

Integrasi dengan play-services-auth diperlukan.

Disederhanakan dan dioptimalkan; tidak play-services-auth diperlukan.

Otorisasi

Kode tambahan untuk keberhasilan, kegagalan, dan percobaan ulang.

Dikelola oleh SDK

Token Akses Server

Dapat meminta cakupan OAuth 2.0 tambahan dengan GoogleSigninClient.

Kode tambahan untuk penanganan error selama login.

Dapat meminta tiga cakupan identitas OAuth 2.0 dasar dengan GamesSignInClient saat meminta akses sisi server ke API web Layanan game Play.

Untuk mengetahui informasi selengkapnya, lihat Akses sisi server ke Layanan game Play dan Mengambil kode autentikasi server.


Proses Login

Menggunakan GoogleSigninClient.

Kode tambahan untuk penanganan kode boilerplate untuk login otomatis dan penanganan error.

Menggunakan GamesSignInClient.

SDK menangani kode boilerplate, login otomatis, dan penanganan error.

Pop-up Selamat Datang

Kode tambahan diperlukan.
Developer dapat mengontrol penempatan dan waktunya.

Tidak diperlukan kode tambahan. Antarmuka pengguna yang konsisten di semua game yang dikonfigurasi dengan SDK game v2.

Dependensi

Memerlukan play-services-auth.

Modul Game menangani otorisasi dan autentikasi. Anda tidak perlu menambahkan dependensi tambahan.
Logout

Menggunakan GoogleSignInClient.signOut.

API keluar tidak didukung.

Beberapa akun Layanan game Play dan setelan per game

Pengelolaan akun dapat dilakukan dalam game Anda.

Pengguna dapat mengubah profil Layanan game Play di setelan perangkat seluler. Untuk mengetahui informasi selengkapnya, lihat cara mengubah profil Play Game di perangkat seluler.