Untuk mengintegrasikan game Anda dengan Layanan game Google Play, terapkan terlebih dahulu autentikasi platform. Hal ini diperlukan untuk mengakses semua fitur lainnya, seperti pencapaian, papan peringkat, dan acara.
Untuk memenuhi pedoman pengalaman pengguna Level Up Google Play Game, game Anda harus mematuhi alur autentikasi yang direkomendasikan.
Inisialisasi dan autentikasi
Ini adalah langkah yang diperlukan untuk menginisialisasi dan mengautentikasi game Anda:
- Terapkan autentikasi platform dengan melakukan inisialisasi SDK Layanan game Play v2 saat startup. Untuk mengetahui informasi selengkapnya, lihat autentikasi platform untuk game Android. Langkah ini diperlukan untuk mengakses fitur Layanan game Play seperti pencapaian dan papan peringkat.
- Otentikasi berjalan sebagai proses latar belakang senyap selama peluncuran game.
Pengguna Layanan game Play yang sudah ada akan melihat pesan selamat datang setelah autentikasi berhasil.
Opsi pembuatan profil
Profil Layanan game Play diperlukan agar pemain dapat berinteraksi dengan platform. Beberapa pemain mungkin tidak memiliki profil Layanan game Play saat mereka memulai game Anda. Pemain ini akan diminta untuk membuatnya.
Anda dapat menentukan pengalaman yang tepat untuk pengguna dengan memilih salah satu opsi berikut:
Perintah pembuatan profil yang dipicu otomatis Perintah pembuatan profil muncul secara otomatis secara default saat Anda meluncurkan game tanpa profil Layanan game Play.
Perintah pembuatan profil saat Anda meluncurkan game (klik untuk memperbesar). Menonaktifkan dialog pembuatan profil saat peluncuran dan menambahkan dialog manual setelah inisialisasi game Anda dapat menonaktifkan dialog pembuatan profil yang dipicu otomatis melalui file manifes. Hal ini memungkinkan pengguna tanpa profil Layanan game Play untuk melanjutkan metode autentikasi yang Anda terapkan tanpa langsung diminta untuk membuat profil Layanan game Play.
Meskipun pengguna dapat login dengan penyedia identitas apa pun, sebaiknya mulai perintah pembuatan profil Dapatkan hasil autentikasi untuk mendorong pendaftaran Platform Layanan game Play. Tampilkan dialog ini sesuai keinginan Anda, tetapi pastikan dialog ini muncul sebelum pengguna membuat kemajuan signifikan dalam fitur seperti pencapaian dan papan peringkat.
Pertimbangkan untuk memicu perintah profil selama momen yang direkomendasikan berikut:
- Setelah menyelesaikan tutorial.
- Selama momen mendapatkan reward (misalnya, memenangkan pertandingan, mengumpulkan item langka, atau mencapai tonggak pencapaian).
- Pada saat meluncurkan sesi kedua.
Alur autentikasi yang direkomendasikan
Untuk memenuhi pedoman pengalaman pengguna Level Up Google Play Game, pastikan Anda mematuhi persyaratan kelangsungan pemain. Agar pemain berhasil login ke game Anda, gunakan alur autentikasi berikut:
- Selama urutan startup game, tinjau opsi pembuatan profil dan pilih salah satu opsi.
- Jika proses login otomatis tidak berfungsi atau pengguna menolak, tampilkan tombol login manual sebagai antisipasi jika pengguna ingin login nanti.
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 game Play. Integrasi klien game, integrasi server game, dan layanan simpan di cloud dapat menggunakan ID ini untuk mengakses data pemain dengan aman dari Layanan game Play.
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.
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 game Play 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.
Beberapa layanan autentikasi
Layanan game Play memberikan identitas game untuk pemain Android, tetapi tidak harus menjadi satu-satunya identitas yang terhubung ke pengguna Anda. Anda dapat mengautentikasi pemain menggunakan Layanan game Play, ID jaringan sosial, dan sistem ID dalam game Anda sendiri sekaligus.
Recall API
Recall API memungkinkan game mengelola link antara pengguna PGS dan akun dalam game mereka dengan menyimpan token recall menggunakan server Google. Untuk mempelajari lebih lanjut cara mengaktifkan fitur ini, lihat Mengintegrasikan PGS Recall API di dalam game Anda.
Integrasi klien game
Saat mengintegrasikan autentikasi ke project game Anda, sebaiknya gunakan alur pengguna berikut:
Selama urutan startup game Anda, Opsi pembuatan profil akan diluncurkan dan melakukan upaya login pengguna atau membuat akun baru.
Jika autentikasi otomatis tidak berfungsi atau pengguna menolak, tampilkan tombol login manual sebagai antisipasi jika pengguna ingin login nanti.
Untuk mengetahui informasi tentang cara mengintegrasikan autentikasi dalam project game Anda, lihat panduan memulai untuk jenis project Anda:
Integrasi server game
Anda dapat memperoleh kode otorisasi server dengan memanggil requestServerSideAccess
setelah Anda memverifikasi bahwa pemain diautentikasi. Teruskan kode otorisasi server ini ke server game backend Anda untuk berkomunikasi langsung dengan server Layanan game Play. Komunikasi ini
memungkinkan server Anda mengakses data pemain, termasuk:
- ID Pemain
- Profil
- Daftar teman
- Progres game
- Pencapaian
Server Anda kemudian menggunakan kode otorisasi ini dengan REST API untuk berinteraksi dengan aman dengan server Layanan game Play. Untuk mengetahui informasi selengkapnya, lihat Akses sisi server ke Layanan game Play.
Kuota permintaan login
Ada kuota harian untuk permintaan login dengan Layanan game Play. Untuk informasi selengkapnya, lihat Mengelola kuota harian.