Teman

Gunakan Friends API untuk melengkapi dan meningkatkan sistem teman dalam game dan sistem sosial lain yang dapat diakses game Anda. Dengan begitu, pemain dapat:

  • Menemukan teman dalam game Anda.

  • Membandingkan skor dengan teman mereka di papan peringkat.

  • Menggabungkan daftar teman Play Game mereka dengan daftar teman dalam game yang sudah ada.

  • Mengidentifikasi pemain lain dengan pop-up profil dalam game. Pop-up ini menunjukkan nama panggilan yang diberikan oleh pemain saat ini kepada temannya, sehingga mereka tahu dengan siapa mereka bermain.

Impor teman

Dasar-dasar

API ini memungkinkan Anda melakukan tindakan berikut:

  • Memuat teman: Anda dapat memeriksa apakah pemain telah mengizinkan game mengakses informasi daftar Teman. Jika akses diberikan, Anda bisa mendapatkan daftar objek Pemain yang sesuai dengan teman dari pemain yang login.
  • Meluncurkan tampilan profil Play Game pemain lain: Anda dapat membuka tampilan ini untuk menampilkan nama yang diberikan kepada pemain lain oleh pemain yang login. Tampilan ini juga menawarkan kontrol pengelolaan pertemanan dan tidak akan mengeluarkan pemain dari game Anda.
  • Memberikan kontrol pengguna: Pengguna memiliki kontrol untuk mengelola cara profil Play Game-nya terlihat oleh teman dan cara daftar teman mereka terlihat di game. Untuk akses daftar teman, pengguna dapat memilih untuk memberikan akses secara otomatis bagi semua game atau mereka dapat memilih untuk menyetujui akses setiap game satu per satu. Karena itu, saat memuat daftar teman, hasilnya dapat berupa callback untuk menampilkan permintaan akses.

Mengimpor daftar teman Play Game

Anda dapat menggunakan Friends API untuk mendapatkan daftar teman Play Game pemain dan menambahkannya ke daftar teman dalam game.

Pengguna baru akan memiliki daftar teman awal untuk diajak bermain, dan pengguna yang sudah ada dapat mengimpor teman Play Game mereka ke dalam daftar teman dalam game. Hasilnya, pengguna Anda akan memiliki kumpulan pemain terbesar untuk bermain atau bersaing.

Menambahkan teman Play Game ke game Anda

Tambahkan teman Play Game ke daftar teman dalam game yang sudah ada dengan mengaitkan ID Play Game dengan informasi pemain yang sesuai di database internal Anda. Pastikan Anda memiliki tombol dengan ikon Play Game di samping teman ini, yang menampilkan profil pemain lain saat ditekan, sehingga pengguna dapat mengetahui siapa teman tersebut.

Saat menggunakan daftar teman dari server backend, muat dengan aman menggunakan REST API, bukan meneruskan hasil Android API. Pastikan untuk menggunakan ID pemain yang ditampilkan oleh players.get(me) di REST API untuk pemain yang sedang login, karena ini akan konsisten dengan ID yang dilihat oleh pemain lain.

Jika daftar teman yang ditambahkan tidak disimpan (tetapi hanya digunakan pada saat melihat), Anda tidak perlu melakukan tindakan tambahan apa pun.

Memberikan akses ke Play Game

Jika game Anda belum memiliki akses ke Play Game, saat yang tepat untuk meminta izin pengguna adalah saat mereka melihat daftar teman dalam game Anda. Misalnya, Anda dapat menambahkan tombol bernama Impor teman Play Game, yang akan meminta izin pengguna saat diketuk. (Pastikan untuk menggunakan logo Play Game pada tombol apa pun yang menyebutkan layanan.)

Melihat profil pemain lain

Anda dapat mengizinkan pemain yang login untuk melihat profil Play Game pemain lain. Hal ini memungkinkan pemain yang login melihat nama yang diberikan kepada pemain lain, dan apakah mereka sudah berteman atau belum, sehingga memberikan konteks tambahan tentang hubungan tersebut. Jika pemain belum berteman, pemain yang login akan melihat kontrol pengelolaan pertemanan pada tampilan profil. Saat pertemanan dibuat dari dalam game, nama default untuk dua pemain tersebut adalah nama mereka dalam game (jika disediakan). Nama game tempat dimulainya pertemanan juga akan ditampilkan.

Melihat profil pemain lain

Papan peringkat sosial

Friends API juga dapat digunakan untuk papan peringkat. Gunakan fitur ini untuk menunjukkan peringkat pemain saat ini di antara teman Play Game-nya. Perhatikan bahwa ini hanya berlaku untuk pengguna yang telah memilih untuk membagikan informasi ini dengan aplikasi Anda, dan jika pengguna tersebut adalah teman di Play Game. Untuk mendukung fitur ini, game menampilkan kontrol kepada pengguna. Kontrol ini menggunakan argumen collection untuk memilih tampilan sosial papan peringkat. Untuk mempelajari lebih lanjut, lihat bagian papan peringkat publik dan sosial.

Jika Anda mengimplementasikan koleksi papan peringkat sosial, panggilan untuk memuat skor papan peringkat dapat menampilkan pengecualian resolusi yang memerlukan izin, serupa dengan yang berasal dari loadFriends(). Jika Anda mengimplementasikan UI default yang disediakan Play Game (misalnya, getLeaderboardIntent()), UI ini akan ditangani secara otomatis.

Langkah berikutnya

Sebelum Anda mulai menggunakan Friends API, lakukan hal berikut: