Arkadaşlar

Mevcut oyun içi arkadaş sisteminizi ve oyununuzun erişebileceği diğer sosyal sistemleri tamamlamak ve geliştirmek için Friends API'lerini kullanın. Bu, oyuncuların aşağıdakileri yapmasına olanak tanır:

  • Oyununuzda arkadaşlarını bulun.

  • Skor tablolarında skorları arkadaşlarıyla karşılaştırın.

  • Play Games arkadaşlarının listesini mevcut oyun içi arkadaş listeleriyle birleştirin.

  • Oyun içi profil pop-up'ıyla başka bir oyuncuyu belirleyin. Bu pop-up'ta mevcut oyuncunun arkadaşına verdiği ve böylece kiminle oynadığını anladığı bir takma ad gösterilmektedir.

Arkadaşları içe aktar

Temel seviye

Bu API'ler aşağıdaki işlemleri gerçekleştirmenizi sağlar:

  • Arkadaş yükleme: Oyuncunun, oyunun arkadaş listesi bilgilerine erişmesine izin verip vermediğini kontrol edebilirsiniz. Erişim izni verilirse oturum açmış oyuncunun arkadaşlarına karşılık gelen Oyuncu nesnelerinin listesini alabilirsiniz.
  • Başka bir oyuncunun Play Games profilinin görünümünü başlatma: Oturum açmış oyuncuya diğer oyuncuya verilen adı göstermek için bu görünümü açabilirsiniz. Bu görünüm aynı zamanda arkadaşlık yönetimi kontrolleri sunar ve oyuncuyu oyundan çıkarmaz.
  • Kullanıcı kontrolleri sağlama: Kullanıcı, Play Games profilinin arkadaşlarına ve arkadaş listesinin oyunlara nasıl görüneceğini kontrol etmeye uygundur. Kullanıcı, arkadaş listesi erişimi için tüm oyunlara otomatik olarak erişim izni vermeyi veya oyunlara erişimi ayrı ayrı onaylamayı tercih edebilir. Sonuç olarak, arkadaş listesi yüklenirken sonuçta bir erişim isteği görüntülenir.

Play Games arkadaş listesini içe aktarma

Friends API'lerini kullanarak oyuncularınızın Play Games arkadaşlarının listesini alabilir ve oyun içi arkadaş listenize ekleyebilirsiniz.

Yeni kullanıcıların başlangıç için bir arkadaş listesi olur ve mevcut kullanıcılar Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilirler. Sonuç olarak, kullanıcılarınız oyun oynamak veya rekabet etmek için mümkün olan en büyük oyuncu grubuna sahip olurlar.

Oyununuza Play Games arkadaşlarınızı ekleyin

Play Games kimliklerini dahili veritabanınızdaki ilgili oyuncu bilgileriyle ilişkilendirerek mevcut oyun içi arkadaş listenize Play Games arkadaşlarınızı ekleyin. Bu arkadaşların yanında Play Games simgesi olan bir düğmeniz olduğundan emin olun. Bu simge, basıldığında diğer oyuncunun profilini gösterir ve kullanıcılarınızın arkadaşlarını tanımalarını sağlar.

Bir arka uç sunucusundan arkadaş listesi kullanırken Android API'nin sonucunu iletmek yerine REST API'yi kullanarak güvenli bir şekilde yükleyin. Şu anda oturum açmış olan oyuncu için REST API'de players.get(me) tarafından döndürülen oyuncu kimliğini kullandığınızdan emin olun. Bu kimlik, diğer oyuncular tarafından görülen kimlikle tutarlıdır.

Artırılmış arkadaş listesi depolanmıyorsa (yalnızca görüntüleme sırasında kullanılıyorsa) herhangi bir ek işleme gerek yoktur.

Play Games'e erişim izni verme

Oyununuz Play Games'e önceden erişemiyorsa oyun içi arkadaş listenizi görüntülediklerinde kullanıcılardan izin istemeleri iyi bir zaman olacaktır. Örneğin, Play Games arkadaşlarını içe aktar adlı bir düğme ekleyebilirsiniz. Bu düğmeden, dokunulduğunda kullanıcıdan izin istenir. (Hizmetten bahseden tüm düğmelerde Play Games logosunu kullandığınızdan emin olun.

Başka bir oyuncunun profilini görüntüleyin

Oturum açmış oyuncunuzun başka bir oyuncunun Play Games profilini görüntülemesine izin verebilirsiniz. Bu özellik, oturum açmış oyuncunun diğer oyuncuya verdiği adı ve arkadaş olup olmadığını görmesini sağlar. Böylece oyuncuyla ilişki hakkında daha fazla bilgi sahibi olabilir. Oyuncular henüz arkadaş değilse oturum açmış oyuncu, profil görünümünde arkadaşlık yönetimi kontrollerini görür. Oyunun içinden arkadaşlıklar oluşturulduğunda, iki oyuncunun varsayılan adları oyun içi adlardır (sağlarsanız). Arkadaşlığın başlatıldığı oyunun adı da gösterilir.

Başka bir oyuncunun profilini görüntüleyin

Sosyal skor tabloları

Friends API'leri, skor tabloları için de kullanılabilir. Mevcut oyuncuyu Play Games arkadaşları arasındaki sıralamada göstermek için bu özelliği kullanın. Bunun yalnızca uygulamanızla ilgili bilgileri paylaşmayı tercih eden kullanıcılar ve Play Games'de arkadaş olması durumunda geçerli olduğunu unutmayın. Oyun, bu özelliği desteklemek amacıyla kullanıcıya bir kontrol olanağı sunar. Bu denetim, skor tablosunun sosyal görünümünü seçmek için collection bağımsız değişkenini kullanır. Daha fazla bilgi edinmek için herkese açık ve sosyal skor tabloları bölümüne bakın.

Skor tablosunda arkadaşlar

Sosyal leaderboard toplama özelliğini uygularsanız skor tablosu puanlarını yükleme çağrısı, loadFriends() ile benzer şekilde izin gerektiren bir çözüm istisnası döndürebilir. Play Games tarafından sağlanan varsayılan kullanıcı arayüzünü (örneğin, getLeaderboardIntent()) uygularsanız bu işlem sizin için otomatik olarak gerçekleştirilir.

Sonraki adımlar

Friends API'lerini kullanmaya başlamadan önce aşağıdakileri yapın: