Recall API memungkinkan game mengelola link antara pengguna Layanan game Google Play (PGS) dan akun dalam game mereka dengan menyimpan token recall menggunakan server Google. Berikut contoh skenario penggunaan Recall API.
Pengguna memainkan game seorang developer yang memiliki sistem identitas untuk melacak progres pengguna, dan menggunakan PGS secara paralel dengan metode autentikasi lainnya untuk mencatat pengguna ke dalam game. Di contoh ini, pengguna diminta login ke akun PGS Laura, dan membuat akun dalam game dengan sistem identitas developer yang disebut Racer94. Saat pengguna memainkan game, server game developer akan menyinkronkan progresnya.
Developer menyimpan token recall secara terpisah ke Google, yang sesuai dengan akun dalam game pengguna. Google otomatis menyimpan token recall tersebut di profil PGS pengguna.
Pengguna dapat memainkan game di GPG di PC untuk pertama kalinya. Pengguna secara otomatis diautentikasi dengan akun PGS-nya, dan klien game akan memeriksa ketersediaan progres untuk pengguna PGS ini. Lalu, server game akan mengkueri Google untuk memeriksa ketersediaan token untuk akun PGS ini. Jika ada, Google akan mengirimkan kembali token recall, dan server game menggunakan token tersebut untuk menemukan akun terkait pengguna Racer94, dan memulihkan progresnya. Karena autentikasi dengan PGS adalah pengalaman yang lancar, progres pengguna dipulihkan oleh aplikasi tanpa pengguna perlu memasukkan nama pengguna atau sandi. Selain itu, developer dapat menggunakan autentikasi PGS dengan sistem identitas yang sudah ada, dan mengandalkan Google untuk menyimpan link antara progres pemain dan akun PGS mereka.
Seperti yang terlihat pada contoh sebelumnya, ada dua tindakan utama yang dilakukan oleh Recall API:
Menyimpan token dengan Google saat pengguna login dengan salah satu akun dalam game.
Mengambil token untuk pengguna guna memulihkan akun dalam game miliknya.
Selain token recall, Recall API juga memerlukan ID stabil yang sesuai dengan akun dalam game, yang disebut persona. Persona bisa dianggap sebagai label yang mewakili akun dalam game pengguna dalam sistem identitas developer, dan token recall bisa dianggap sebagai kunci yang digunakan untuk memulihkan akun dalam game pengguna ke game. Nilai persona dan token tidak boleh digunakan kembali di berbagai project PGS. Selain itu, meskipun token recall dapat diubah dari waktu ke waktu, persona harus stabil sesuai dengan akun dalam game pengguna.
Alur teknis untuk menyimpan dan mengambil token recall
Bagian ini membahas alur teknis antara klien dan server game dengan server Google saat menyimpan dan mengambil token recall.
Langkah 1: Lakukan autentikasi Pengguna PGS dan ambil ID sesi
Game akan menginisialisasi PGS SDK dan mencoba mengautentikasi pengguna dengan PGS.
Dengan asumsi pengguna sudah diautentikasi, minta ID sesi dari SDK Game di klien game, dan minta token OAuth 2.0 dari backend OAuth Google. ID sesi dan token OAuth 2.0 digunakan untuk berkomunikasi dengan backend Google Game.
Langkah 2: Ambil token recall yang tersedia
Meminta token recall yang terkait dengan akun pengguna PGS. Jika token tersedia, lanjutkan ke Langkah 3a dan pulihkan progresnya. Atau, jika akun ini adalah pengguna baru dan tidak memiliki token, lanjutkan ke Langkah 3b dan simpan token baru.
Langkah 3a: Jika token tersedia, pulihkan progres
Jika token tersedia, ambil dan dekripsi token tersebut, serta pulihkan data pengguna.
Langkah 3b: Jika token tidak tersedia, simpan token
Karena tidak ada token yang tersedia, tidak ada progres yang dipulihkan. Pengguna melanjutkan autentikasi platform dengan sistem identitas developer, atau membuat akun baru jika tidak memiliki akun. Catatan - autentikasi ini tidak dilakukan dengan PGS (karena sudah dilakukan), tetapi dengan sistem identitas developer di luar PGS.
Buat token recall terenkripsi yang mengenkode akun dalam game pengguna, dan kirim ke Google bersama dengan ID sesi dan token OAuth 2.0. Di tahap ini, Google akan membuat atribusi antara token recall yang dikirim, dan akun PGS pemain.
Alur untuk pengguna tanpa profil PGS
Anda dapat menyimpan token recall untuk pengguna yang belum membuat profil PGS dengan menggunakan mode tanpa profil. Namun, ada dua peringatan penting:
- Anda tidak dapat mengambil token untuk pengguna yang tidak memiliki profil PGS. Pembuatan profil otomatis diminta saat pengguna mencoba login ke game Anda dengan Layanan game Play di perangkat kedua.
- Anda harus mengikuti pedoman tambahan
untuk memastikan Anda memiliki pemberitahuan yang sesuai yang menjelaskan item berikut dan
mendapatkan izin yang sesuai dari pengguna akhir:
- Pembagian data Anda kepada Google untuk mengaktifkan fitur penautan akun Play Game.
- Ketersediaan setelan untuk mengelola berbagi ini, seperti setelan Play Game.
- Pemrosesan data tersebut berdasarkan Kebijakan Privasi Google.
Menyimpan pasangan token dan persona
- Pengguna tanpa profil PGS membuka game yang mengaktifkan fitur recall tanpa profil.
- Games SDK memicu autentikasi platform otomatis, yang gagal karena pengguna tidak memiliki profil PGS.
- SDK Game menampilkan snackbar yang memberi tahu pengguna bahwa game telah terintegrasi dengan Google. Snackbar ini dapat ditindaklanjuti—pengguna dapat menonaktifkan pemberitahuan penarikan kembali hingga profil dibuat.
- Game meminta akses untuk mengingat. Perhatikan bahwa PGS menolak permintaan akses recall jika ada profil PGS di perangkat atau jika tidak ada Akun Google di perangkat. Dalam hal ini, game harus dilanjutkan tanpa menggunakan PGS.
- Setelah pengguna login dengan akun dalam game, game akan membuat pasangan token dan persona untuk pengguna yang sesuai dengan akun dalam game-nya. Game menyimpan pasangan ini dengan Google. Game dapat menyimpan lebih banyak token nanti jika pengguna login ke akun dalam game lainnya.
Meluncurkan game di perangkat baru
- Pengguna tanpa profil PGS membuka game yang mengaktifkan fitur recall tanpa profil di perangkat.
- Game mencatat token recall tanpa profil seperti yang dijelaskan dalam Menyimpan pasangan token dan persona.
- Pengguna membuka game yang sama di perangkat lain yang memiliki penyiapan akun yang sama.
- SDK Game memicu pembuatan profil. Pengguna dapat meninjau dan menolak token Recall yang disimpan sebelumnya. Pengguna membuat profil PGS pada saat ini.
- Autentikasi platform otomatis ke PGS selesai, dan game menerima status yang diautentikasi.
- Game mengambil token Recall untuk pengguna seperti biasa.
Langkah berikutnya
Untuk mengintegrasikan Recall API dengan klien dan server game Anda, ikuti panduan ini.