Autentikasi platform

Langkah pertama dalam mengintegrasikan game Anda dengan Layanan game Google Play (PGS) adalah menerapkan Autentikasi Platform. Hal ini diperlukan untuk mengakses semua fitur lainnya seperti pencapaian, papan peringkat, dan peristiwa.

Karena Layanan Play Games SDK otomatis melakukan autentikasi platform saat peluncuran game, Anda perlu mengintegrasikan PGS v2 SDK dengan game Anda dan menerapkan alur autentikasi yang direkomendasikan, sehingga game Anda siap untuk 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 akan 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.
• Terpisah: Anda tidak boleh menggunakan Layanan Play Games sebagai sistem identitas utama game untuk mengelola akun dalam game (IGA), progres game, atau inventaris pemain. Layanan Play Games berfungsi sebagai ID platform yang persisten.

ID Pemain

ID pemain adalah ID untuk akun pemain Layanan Play Games. 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 mengetahui informasi selengkapnya, lihat ID Pemain generasi berikutnya.

Autentikasi dalam game

Anda mengelola akun dalam game (IGA), yang merupakan sistem identitas yang mengikat progres pemain, inventaris, dan mata uang dalam game Anda.

• Identitas Utama: Anda dapat menggunakan backend sendiri, Login dengan Google (SiWG), atau penyedia lainnya 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 antar-IGA. Saat pemain beralih akun, mereka tetap diautentikasi ke platform Play Game melalui PGS, dan Anda terus mengirimkan data mereka yang terkait dengan pencapaian dan fitur PGS lainnya terhadap ID Pemain yang persisten.

Kontinuitas lintas platform dengan SiWG

Untuk membantu pemain membawa progres mereka di Android, iOS, dan web, gunakan Login dengan Google sebagai metode autentikasi dalam game utama. Pertimbangkan hal berikut:

• Tombol Login dengan Google: Di PGS v1, tombol Google Play sering menangani login platform dan game. Di v2, ini adalah proses yang terpisah. Terapkan tombol Login dengan Google standar agar pemain dapat mengautentikasi 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 menginisialisasi dan mengautentikasi game Anda:

Terapkan autentikasi platform dengan menginisialisasi Layanan Play Games v2 SDK saat startup. 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 yang sudah ada 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:

Petunjuk pembuatan profil yang dimulai otomatis

Petunjuk pembuatan profil yang dimulai otomatis muncul secara default saat Anda meluncurkan game tanpa profil Layanan Play Games.

Menghentikan petunjuk pembuatan profil yang dimulai otomatis

Nonaktifkan petunjuk profil saat peluncuran dengan mengonfigurasi file manifes untuk mencegah petunjuk yang dimulai 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 petunjuk pembuatan profil untuk mendorong mereka melakukan autentikasi dengan autentikasi platform Play Game. Tampilkan petunjuk ini sesuai kebutuhan, tetapi pastikan petunjuk ini muncul sebelum pengguna membuat progres yang signifikan dalam fitur seperti pencapaian dan papan peringkat.

Pertimbangkan untuk memicu petunjuk profil selama momen yang direkomendasikan ini:

• Setelah menyelesaikan tutorial.
• Selama momen berhadiah (misalnya, memenangkan pertandingan, mengumpulkan item langka, atau mencapai pencapaian).
• Pada saat meluncurkan sesi kedua.

Untuk mengetahui informasi selengkapnya, lihat Mencegah pembuatan profil yang dimulai otomatis (Java) dan Mencegah pembuatan profil yang dimulai 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:

1. Jika sesi game aktif ada di perangkat, izinkan pemain melanjutkan sesi saat ini.
2. Jika tidak ada sesi game aktif:
   1. Dalam kasus skenario pemulihan yang lancar saat IGA yang terakhir dimainkan dikaitkan dengan ID Pemain PGS, lanjutkan untuk memulihkan IGA terkait secara otomatis.
   2. Jika tidak, tampilkan layar login atau pembuatan akun yang ditetapkan aplikasi Anda kepada pemain. Pemain kemudian dapat memilih metode autentikasi pilihan mereka untuk membuat atau login ke IGA yang ada.

Cakupan OAuth

Layanan Play Games 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 Game 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.

Pedoman pengalaman pengguna untuk alur autentikasi yang ideal

Pedoman berikut menjelaskan alur autentikasi yang direkomendasikan dengan integrasi PGS v2. Pedoman ini mencakup skenario untuk pengguna baru, pengguna yang sudah ada, dan pengguna yang kembali, serta mode tamu.

Pemain baru

Alur ini berlaku untuk pengguna yang meluncurkan game untuk pertama kalinya di perangkat tanpa histori game sebelumnya.

1. Saat diluncurkan, PGS SDK akan diinisialisasi untuk mengautentikasi identitas platform pengguna (ID Pemain PGS).
2. 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.
3. Setelah pemain membuat atau memilih IGA, game akan mengikat akun ini ke ID utama yang dipilih di backend-nya.
4. Game juga mengikat IGA yang dipilih ini ke ID Pemain PGS, 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 memberikan pengalaman masuk yang lancar.

1. Saat pemain meluncurkan aplikasi, PGS akan melakukan autentikasi secara senyap di latar belakang, sehingga Anda akan mendapatkan ID Pemain untuk melacak progres pencapaian dan fitur game lainnya.
2. Secara bersamaan, jika berlaku, game akan melewati layar login dan langsung membuat pemain login ke sesi IGA aktif atau IGA yang terakhir dimainkan yang terkait dengan ID Pemainnya, 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.

1. Pemain logout dari IGA saat ini, tetapi koneksi platform PGS tetap aktif.
2. 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, menginstal ulang, atau di perangkat yang benar-benar baru. Sebaiknya game menerapkan pemulihan yang lancar.

1. Saat diluncurkan, PGS akan mengautentikasi pengguna dan memberikan ID Pemain PGS ke game.
2. Game akan memeriksa backend-nya (atau token recall yang diambil jika menggunakan Recall API) untuk melihat apakah IGA yang terakhir dimainkan sudah ditautkan ke ID PGS ini.
3. Jika link ditemukan, game akan otomatis memulihkan progres pemain dan membuat mereka login, sehingga layar login manual akan dilewati sepenuhnya.
4. Jika tidak, game akan menampilkan layar login kepada pemain
   1. Pemain kemudian memilih metode login dan login ke IGA
   2. Game kemudian 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 tetap 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.