Langkah pertama dalam mengintegrasikan game Anda dengan Layanan Google Play Games (PGS) adalah mengimplementasikan Autentikasi Platform. Hal ini diperlukan untuk mengakses semua fitur lainnya seperti pencapaian, papan peringkat, dan acara.
Karena SDK Layanan Play Games otomatis melakukan autentikasi platform saat peluncuran game, Anda perlu mengintegrasikan SDK PGS v2 dengan game dan menerapkan alur autentikasi yang direkomendasikan, sehingga game Anda siap menerapkan dan memenuhi pedoman pengalaman pengguna Google Play Games Level Up.
Konsep autentikasi
Di Layanan Play Games v2, konsep "login" dipisahkan menjadi dua lapisan yang berbeda: autentikasi platform dan autentikasi dalam game.
Autentikasi platform
Layanan game Play menyediakan lapisan engagement platform. Layanan ini mengelola hubungan pemain Anda dengan ekosistem Google Play Game menggunakan Profil Gamer, untuk mengakses fitur seperti pencapaian, papan peringkat, dan misi. Autentikasi platform memiliki karakteristik utama berikut:
- Senyap dan otomatis: Autentikasi terjadi secara otomatis di latar belakang saat game diluncurkan. Layanan Play Games tidak memerlukan tombol Login manual.
- ID Pemain: Setelah autentikasi platform berhasil, Layanan Play Games memberikan ID Pemain yang stabil. ID ini konsisten di seluruh perangkat untuk game yang sama. Gunakan ID ini terutama untuk melacak fitur platform, seperti progres pencapaian.
- Dipisahkan: Anda tidak boleh menggunakan Layanan Play Games sebagai sistem identitas utama game Anda untuk mengelola akun dalam game (IGA), progres game, atau inventaris pemain. Layanan Play Games berfungsi sebagai ID platform persisten.
ID Pemain
ID pemain adalah ID untuk akun pemain Layanan game Play. Game Anda dapat mengambil ID pemain untuk setiap pemain yang login ke game Anda menggunakan autentikasi Layanan Play Games. Integrasi klien game, integrasi server game, dan layanan simpan di cloud dapat menggunakan ID ini untuk mengakses data pemain dengan aman dari Layanan Play Games.
ID pemain konsisten bagi pengguna saat mereka memainkan game Anda di beberapa perangkat. Namun, hal tersebut tidak selalu konsisten di antara game. Untuk informasi selengkapnya, lihat ID Pemain generasi berikutnya.
Autentikasi dalam game
Anda mengelola akun dalam game (IGA), yang merupakan sistem identitas yang mengikat progres, inventaris, dan mata uang pemain dalam game Anda.
- Identitas Utama: Anda dapat menggunakan backend Anda sendiri, Login dengan Google (SiWG), atau penyedia lain sebagai metode login utama.
- Independensi: Pemain dapat login ke Layanan Play Games (Identitas Platform) untuk mendapatkan pencapaian saat login ke IGA tertentu (misalnya, akun tamu atau akun SiWG tertentu).
- Pengelolaan beberapa IGA: Layanan game Play hanya menangani autentikasi platform. Game Anda mengelola autentikasi utama pemain ke IGA mereka. Artinya, tidak ada perubahan pada alur game yang ada bagi pemain untuk beralih di antara IGA mereka. Saat pemain beralih akun, mereka tetap diautentikasi ke platform Play Game melalui PGS, dan Anda terus mengirim data mereka yang terkait dengan pencapaian dan fitur PGS lainnya terhadap ID Pemain persisten.
Kontinuitas lintas platform dengan SiWG
Untuk membantu pemain melanjutkan progres mereka di Android, iOS, dan web, gunakan Login dengan Google sebagai metode autentikasi utama dalam game. Pertimbangkan hal berikut:
- Tombol Login dengan Google: Di PGS v1, tombol Google Play sering kali menangani login platform dan game. Di v2, proses ini terpisah. Terapkan tombol Login dengan Google standar agar pemain dapat melakukan autentikasi dan mengakses IGA mereka.
- SDK Login dengan Google:
- Untuk Android dan iOS, gunakan SDK Login dengan Google standar untuk mengautentikasi pemain ke IGA mereka.
- Gunakan Google Open ID sebagai ID utama untuk akun dalam game pemain.
- Gunakan ID Pemain Layanan Play Games untuk melaporkan progres pemain pada fitur Play Games, seperti pencapaian.
Integrasi yang direkomendasikan
Untuk mengintegrasikan game Anda dengan Layanan Play Games, ikuti langkah-langkah yang direkomendasikan berikut:
Inisialisasi dan autentikasi
Langkah ini diperlukan untuk melakukan inisialisasi dan mengautentikasi game Anda:
Terapkan autentikasi platform dengan melakukan inisialisasi SDK Layanan Play Games v2 saat memulai. Untuk mengetahui informasi selengkapnya, lihat autentikasi platform untuk game Android. Langkah ini diperlukan untuk mengakses fitur Layanan Play Games, seperti pencapaian dan papan peringkat.
Autentikasi berjalan sebagai proses latar belakang yang tidak terlihat saat game diluncurkan. Pengguna Layanan Play Games akan melihat pesan selamat datang setelah autentikasi berhasil. Pengguna yang tidak memiliki profil Layanan Play Games akan diminta untuk membuat profil selama inisialisasi SDK.

Pembuatan profil
Pemain memerlukan profil Layanan game Play untuk berinteraksi dengan platform. Beberapa pemain mungkin tidak memiliki profil Layanan game Play saat mulai memainkan game Anda. Mereka kemudian akan diminta untuk membuat profil. Anda dapat menentukan pengalaman yang tepat bagi pengguna dengan memilih salah satu opsi berikut:
Perintah pembuatan profil yang dipicu secara otomatis
Petunjuk pembuatan profil yang dimulai otomatis muncul secara default saat Anda meluncurkan game tanpa profil Layanan game Play.
Menghentikan perintah pembuatan profil yang dipicu secara otomatis
Nonaktifkan perintah profil saat peluncuran dengan mengonfigurasi file manifes untuk mencegah perintah yang dipicu secara otomatis. Hal ini memungkinkan pengguna tanpa profil Layanan Play Games untuk terus memuat game tanpa diminta membuat profil Layanan Play Games.
Meskipun pengguna dapat login dengan penyedia identitas apa pun, Anda harus menampilkan perintah pembuatan profil untuk mendorong mereka melakukan autentikasi dengan autentikasi platform Play Game. Tampilkan dialog ini sesuai kebutuhan, tetapi pastikan dialog ini muncul sebelum pengguna membuat progres yang signifikan dalam fitur seperti pencapaian dan papan peringkat.
Pertimbangkan untuk memicu perintah profil selama momen yang direkomendasikan berikut:
- Setelah menyelesaikan tutorial.
- Selama momen reward (misalnya, memenangkan pertandingan, mengumpulkan item langka, atau mencapai pencapaian).
- Saat meluncurkan sesi kedua.
Untuk mengetahui informasi selengkapnya, lihat Mencegah pembuatan profil yang dipicu secara otomatis (Java) dan Mencegah pembuatan profil yang dipicu secara otomatis (Unity).
Autentikasi dalam game
Setelah autentikasi platform berhasil dijalankan, developer harus menerapkan langkah-langkah berikut agar pemain dapat mengakses IGA mereka, bergantung pada status game saat ini:
- Jika ada sesi game aktif di perangkat, izinkan pemain untuk melanjutkan sesi saat ini.
- Jika tidak ada sesi game aktif:
- Dalam skenario pemulihan lancar saat IGA yang terakhir dimainkan dikaitkan dengan ID Pemain PGS, lanjutkan untuk otomatis memulihkan IGA terkait.
- Jika tidak, tampilkan layar login atau pembuatan akun yang ditentukan aplikasi Anda kepada pemain. Pemain kemudian dapat memilih metode autentikasi pilihan mereka untuk membuat atau login ke IGA yang ada.
Cakupan OAuth
Layanan game Play mengandalkan
sistem OAuth
untuk memungkinkan pemain memberi game Anda akses ke akun mereka. Layanan game Play
memiliki cakupan unik untuk game (games-lite) dan bergantung pada cakupan lain
(drive.appdata) jika game Anda menggunakan fitur game tersimpan. Fitur game tersimpan
memberikan akses ke akun Google Drive pengguna, tempat penyimpanan data game.
Saat menggunakan SDK Layanan Play Games v2, Anda dapat meminta cakupan OAuth tambahan.
Jika Anda memerlukan cakupan OAuth tambahan, sebaiknya panggil requestServerSideAccess.
Untuk mengetahui informasi selengkapnya, lihat
mendapatkan kode autentikasi server atau mengambil kode autentikasi server.
Panduan pengalaman pengguna untuk alur autentikasi yang ideal
Panduan berikut menjelaskan alur autentikasi yang direkomendasikan dengan integrasi PGS v2. Skenario ini mencakup skenario untuk pengguna baru, lama, dan yang kembali, serta mode tamu.
Pemain baru
Alur ini berlaku untuk pengguna yang meluncurkan game untuk pertama kalinya di perangkat tanpa histori bermain game sebelumnya.
- Setelah diluncurkan, PGS SDK akan melakukan inisialisasi untuk mengautentikasi identitas platform pengguna (ID Pemain PGS).
- Setelah handshake latar belakang ini, game akan menampilkan opsi pembuatan IGA kepada pemain, misalnya, Buat akun baru, Login dengan Google, atau metode login sosial lainnya.
- Setelah pemain membuat atau memilih IGA, game akan mengikat akun ini ke ID utama yang dipilih di backend-nya.
- Game ini juga mengikat IGA yang dipilih ini ke ID Pemain PGS, yang menandainya sebagai IGA yang terakhir dimainkan untuk pemulihan yang lancar.
Pemain dengan sesi aktif
Skenario ini menjelaskan pemain yang meluncurkan game di perangkat tempat mereka sudah memiliki sesi aktif. Tujuannya adalah untuk memberikan pengalaman masuk yang lancar.
- Saat pemain meluncurkan aplikasi, PGS akan otomatis melakukan autentikasi di latar belakang dan memberi Anda ID Pemain untuk melacak progres pencapaian dan fitur game Play lainnya.
- Secara bersamaan, jika berlaku, game akan mengabaikan layar login dan segera membuat pemain login ke sesi IGA aktif atau IGA yang terakhir dimainkan yang terkait dengan ID Pemain, sehingga mereka dapat segera melanjutkan gameplay.
Pemain yang beralih akun
Alur ini terjadi saat pemain dengan sesi aktif membuka setelan game untuk beralih akun. Misalnya, logout dari akun utama untuk menggunakan akun alternatif.
- Pemain logout dari IGA saat ini, tetapi koneksi platform PGS tetap aktif.
- Saat pemain login dengan IGA yang berbeda, game akan mengikat akun baru ini ke ID Pemain PGS saat ini sebagai IGA yang terakhir dimainkan hanya untuk pemulihan yang lancar.
Pemulihan yang lancar untuk pemain yang kembali
Skenario ini berlaku saat pemain meluncurkan game setelah periode tidak aktif, penginstalan ulang, atau di perangkat yang benar-benar baru. Game direkomendasikan untuk menerapkan pemulihan yang lancar.
- Saat diluncurkan, PGS mengautentikasi pengguna dan memberikan ID Pemain PGS ke game.
- Game akan memeriksa backend-nya (atau token recall yang diambil jika menggunakan API Recall) untuk melihat apakah IGA yang terakhir dimainkan sudah ditautkan ke ID PGS ini.
- Jika link ditemukan, game akan otomatis memulihkan progres pemain dan membuat mereka login, sehingga melewati layar login manual sepenuhnya.
- Jika tidak, game akan menampilkan layar login kepada pemain
- Pemain kemudian memilih metode login dan login ke IGA
- Kemudian, game akan mengikat IGA ini dengan ID pemain PGS sebagai IGA yang terakhir dimainkan untuk pemulihan yang lancar.
Mode tamu
Pemain dapat meluncurkan game Anda dan bermain menggunakan akun tamu lokal. Layanan Play Games masih mengautentikasi pemain di latar belakang. Jika pemain memilih Simpan Progres, game Anda akan mengonversi sesi tamu menjadi IGA permanen dan mengikatnya ke ID pemain. Untuk mengetahui informasi selengkapnya tentang penyelesaian konflik, lihat Akun tamu.
Menguji game Anda
Pastikan game Anda berfungsi sesuai desain dengan mengujinya. Pengujian yang Anda lakukan bergantung pada fitur game Anda.
Berikut adalah daftar pengujian umum yang dapat dijalankan.
Login berhasil.
Login otomatis berfungsi. Pengguna harus login ke Layanan Play Games saat meluncurkan game.
Pop-up sambutan ditampilkan.
Contoh pop-up sambutan (klik untuk memperbesar). Pesan log yang berhasil akan ditampilkan. Jalankan perintah berikut di terminal:
adb logcat | grep com.google.android.
Pesan log yang berhasil ditampilkan dalam contoh berikut:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
Memastikan konsistensi komponen UI.
Pop-up, papan peringkat, dan pencapaian ditampilkan dengan benar dan konsisten di berbagai ukuran dan orientasi layar di antarmuka pengguna (UI) Layanan Play Games.
Opsi logout tidak terlihat di UI Layanan Play Game.
Pastikan Anda dapat berhasil mengambil ID Pemain, dan jika berlaku, kemampuan sisi server berfungsi seperti yang diharapkan.
Jika game menggunakan autentikasi sisi server, uji alur
requestServerSideAccesssecara menyeluruh. Pastikan server menerima kode autentikasi dan dapat menukarnya dengan token akses. Uji skenario keberhasilan dan kegagalan untuk error jaringan, skenarioclient IDyang tidak valid.
Jika game Anda menggunakan salah satu fitur berikut, uji fitur tersebut untuk memastikan bahwa fitur tersebut berfungsi sama seperti sebelum migrasi:
- Papan peringkat: Mengirimkan skor dan melihat papan peringkat. Periksa peringkat dan tampilan nama serta skor pemain yang benar.
- Pencapaian: Buka pencapaian dan verifikasi bahwa pencapaian tersebut dicatat dan ditampilkan dengan benar di UI Play Game.
- Game Tersimpan: Jika game menggunakan game tersimpan, pastikan penyimpanan dan pemuatan progres game berfungsi dengan sempurna. Hal ini sangat penting untuk diuji di beberapa perangkat dan setelah update aplikasi.