Login

Login Layanan game Play memberi Anda identitas game pemain yang merupakan identitas khusus platform tingkat game untuk pemain Android. Identitas ini membantu membangun hubungan antara game Anda dan pemain. Pemain lebih memilih menggunakan identitas ini untuk login daripada dengan sistem terpusat alternatif.

Selain itu, login memberi Anda ID yang kuat dan konsisten yang dapat digunakan sebagai kunci untuk sistem simpan di cloud. Sistem simpan di cloud sangat penting karena memungkinkan pemain melakukan berbagai hal berikut:

  • Melanjutkan game jika mereka mengubah atau mereset perangkat
  • Memainkan game di beberapa perangkat (misalnya, di ponsel lain atau Chromebook)
  • Meng-uninstal lalu menginstal ulang game

Anda dapat menggunakan identitas Layanan game Play sebagai kunci untuk solusi simpan di cloud Anda sendiri, atau Anda dapat menggunakan Layanan Game Tersimpan secara gratis.

Layanan game Play (PGS) mendukung login otomatis, cara tanpa hambatan untuk membuat pemain login, serta login manual, yang merupakan proses sekali klik. Dokumen ini menjelaskan berbagai metode login ini.

Alur login yang direkomendasikan

Agar pemain berhasil login ke game Anda, gunakan alur login berikut:

  1. Selama urutan startup game, coba Login otomatis untuk membuat pemain login secara otomatis.
  2. Jika login otomatis tidak berfungsi dan perangkat pengguna sedang online, coba Login manual.
  3. Jika login manual ditolak, ingat pilihan pengguna dan jangan tampilkan login manual lagi, tetapi terus coba Login otomatis saat memulai.

Selain itu, Anda harus memastikan bahwa pengguna dapat login ke game Anda dengan akun Layanan game Play mereka menggunakan tombol khusus yang mudah ditemukan.

Login otomatis

Login otomatis memungkinkan pengguna login ke game Anda tanpa hambatan - semuanya otomatis. Jika game Anda meminta pengguna untuk login dan setelan login otomatis diaktifkan (di aplikasi Google Play Game), Anda akan menerima kredensial identitas PGS pengguna dan pengguna akan melihat pengalaman login PGS.

Login otomatis adalah setelan yang dapat dikontrol oleh pengguna. Pengguna dapat memilih untuk login otomatis ke semua game atau minta ditanya setiap kali login.

Login otomatis

Login manual

Jika pengguna tidak otomatis login ke game, Anda dapat meminta mereka untuk login secara manual. Pengguna dapat login dengan sekali klik dari kotak dialog yang ditampilkan di atas game Anda.

Login manual

Mengizinkan pop-up PGS untuk pengalaman login yang benar

Saat menggunakan PGS, pengguna perlu mengetahui bahwa mereka sudah login. Hal ini dilakukan dengan menampilkan pengalaman login PGS.

Untuk menampilkan pengalaman login, panggil metode setViewForPopups() dari class GamesClient selama startup game. Hal ini sangat penting untuk memungkinkan pengalaman pengguna yang benar.

Cakupan OAuth dan PGS

PGS mengandalkan sistem OAuth untuk memungkinkan pengguna memberi game Anda akses ke akun mereka. Cakupan OAuth adalah izin yang dapat Anda minta sebagai developer. Jika diberikan, izin ini memungkinkan game Anda memanggil API tertentu atas nama pengguna dan juga memberi Anda akses ke bagian tertentu dari Akun Google mereka.

PGS 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.

Game Anda dapat meminta cakupan apa pun yang Anda perlukan untuk menciptakan pengalaman game yang luar biasa bagi pengguna. Game Anda dapat meminta semua cakupan yang diperlukan dalam satu paket, yang membatasi jumlah permintaan untuk akses akun Google. Namun, pendekatan ini memiliki kelemahan utama. Jika Anda meminta lebih dari cakupan khusus PGS, login otomatis tidak akan berhasil. Login otomatis adalah cara terbaik untuk membuat pemain login ke game Anda.

Praktik terbaiknya adalah menggunakan permintaan cakupan inkremental. Game Anda harus meminta cakupan khusus PGS terlebih dahulu dalam permintaan awal, dan meminta cakupan lain secara terpisah pada saat yang lebih relevan.

Akses OAuth diberikan menggunakan layar yang berbeda untuk setiap cakupan. Hal ini memungkinkan pengguna untuk memutuskan, secara terperinci, cakupan mana yang akan diberi akses. Dengan menggunakan login otomatis hanya dengan cakupan PGS, pengguna tidak perlu berinteraksi dengan perintah OAuth, sehingga mengurangi hambatan login.

Dukungan untuk metode multi-login

PGS memberikan identitas game untuk pemain Android, tetapi tidak harus menjadi satu-satunya identitas yang terhubung ke pengguna Anda. Anda dapat memproses login pemain menggunakan PGS, ID jaringan sosial, dan sistem ID dalam game Anda sendiri sekaligus. Setiap sistem memberikan nilai yang unik bagi Anda dan pemain, dan semuanya dapat bekerja sama untuk memberikan pengalaman yang luar biasa bagi pemain Android.

Mengambil dan memverifikasi identitas pemain dengan aman untuk integrasi backend

Anda dapat meminta kode Autentikasi Server agar server Anda dapat berkomunikasi langsung dengan server Layanan game Play melalui REST API dengan otorisasi dari pemain yang login. Hal ini memungkinkan akses langsung ke ID, profil, dan informasi pemain lainnya (seperti daftar teman, jika diizinkan). Jika Anda menyimpan ID Pemain, ID teman, atau data terkait lainnya di backend, metode ini harus digunakan untuk menghapus potensi manipulasi kolom perangkat ini.

Selain itu, untuk beberapa game dan pemain lama, ID pemain yang ditampilkan oleh SDK Android untuk pemain mungkin bukan ID yang sama dengan yang dilihat pemain lain saat melihat pemain tersebut dalam game yang sama, dan ini sangat relevan saat menggunakan daftar teman. Namun, player_id yang ditampilkan dalam REST API selalu konsisten dan selalu merupakan ID yang dilihat oleh pemain lain.

Untuk informasi selengkapnya, baca Akses offline dan dokumentasi REST API.

Implementasi klien

Untuk mempelajari cara mengimplementasikan dukungan login di Android, lihat Login di Game Android.