Arkadaşlar

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

  • Oyununuzda arkadaşlarını bulun.

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

  • Play Games arkadaşlarının listesini mevcut oyun içi listelerle arkadaş.

  • Oyun içi profil pop-up'ı ile başka bir oyuncu tanımlayın. Bu pop-up'ta bir Böylece, mevcut oyuncunun arkadaşına verdiği takma ad bilgi edinir.

Arkadaşları içe aktar

Temel seviye

Bu API'ler aşağıdaki işlemleri gerçekleştirmenize olanak tanır:

  • Arkadaşları yükle: Oyuncunun oyunun erişmesine izin verip vermediğini kontrol edebilirsiniz Arkadaş listesi bilgileri. Erişim izni verilirse oyuncuların listesini alabilirsiniz oturum açmış oyuncunun arkadaşlarına karşılık gelen nesneler içerir.
  • Başka bir oyuncunun Play Games profilinin görünümünü başlatma: oturum açmış kullanıcının diğer oyuncuya verdiği adı göstermek için oynatıcıya gitmiş olur. Bu görünüm ayrıca arkadaşlık yönetimi kontrolleri de sunar ve oyuncuyu oyundan çıkarır.
  • Kullanıcı kontrolleri sağlama: Kullanıcı, kullanıcı denetimlerinin nasıl yapılacağını yönetebileceği Play Games profili arkadaşlarınız tarafından ve arkadaş listelerinin nasıl olduğu görebilir oyunlar tarafından görülebilir. Arkadaş listesine erişim için kullanıcı tüm oyunlara otomatik olarak erişim izni verebilir veya tek tek her oyun için erişimi onaylayın. Dolayısıyla, arkadaş listesini yüklerken sonuç, erişim isteğini gösteren bir geri çağırma olabilir.

Play Games arkadaş listesini içe aktarma

Oyuncularınızın Play Games listesini almak için Friends API'sini kullanabilirsiniz seçip oyun içi arkadaş listenize ekleyebilirsiniz.

Yeni kullanıcıların birlikte oynayacakları arkadaşlarının ve mevcut kullanıcıların da bir başlangıç listesi olacaktır. Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilirler. Sonuç olarak kullanıcılarınız, oynayabilecekleri en geniş oyuncu grubuna sahip olur rekabet etmesini sağlar.

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

Play Games arkadaşlarınızı mevcut oyun içi arkadaş listelerine ekleyin. oyun kimliğini ilgili oyuncu bilgileriyle ilişkilendirmesini kontrol edebilirsiniz. Play Games'de bir düğmeniz olduğundan emin olun bu arkadaşların yanında, basıldığında diğer oyuncunun profilini gösteren simge, Böylece kullanıcılarınız arkadaşlarının kim olduğunu bilebilir.

Bir arka uç sunucusundan alınan arkadaş listesini kullanırken güvenli bir şekilde yükleyin REST API'yi kullanmalarını öneririz. Şunlardan emin olun: şunun için REST API'de players.get(me) tarafından döndürülen oynatıcı kimliğini kullanmak diğer kullanıcılar tarafından görülen kimlikle tutarlı olacağı için oturum şu anda oturum açmış durumdaki oynatıcı oyunculardan biri.

Artırılmış arkadaş listesi depolanmaz (ancak yalnızca görüntülenebilir), başka bir işlem yapmanıza gerek yoktur.

Play Games'e erişim izni verin

Oyununuzun Play Games erişimi yoksa Kullanıcılar oyun içi arkadaş listenizi görüntülediklerinde izin isterler. Örneğin, Örneğin, Play Games arkadaşlarını içe aktar adlı bir düğme ekleyebilirsiniz. dokunulduğunda kullanıcıdan izin ister. ( Hizmetten bahseden herhangi bir düğmede Play Games logosu.

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

Oturum açmış oynatıcınızın, başka bir oyuncunun Play Games profili. Bu işlem, oturum açmış olan oyuncunun oyuncunun adını ve o oyuncunun zaten arkadaş olup olmadıklarını ilişki hakkında bilgi sağladı. Oyuncular henüz arkadaş değilse Oturum açmış oyuncu, profilde arkadaşlık yönetimi kontrollerini görür görünüm. Oyunun içinden arkadaşlıklar oluşturulduğunda iki oyuncu, oyun içi adlarıdır (varsa). Kişinin adı arkadaşlığın başlatıldığı oyun da gösteriliyor.

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

Sosyal skor tabloları

Friends API'si skor tabloları için de kullanılabilir. Bu özelliği kullanarak mevcut oyuncunun Play Games arkadaşları arasındaki sıralaması. Lütfen Bu yalnızca, söz konusu bilgileri Google Hesabınızla paylaşmayı uygulama ve kullanıcıların Play Games'de arkadaş olup olmadığı. Bunu desteklemek için özelliği ile oyun, kullanıcıya kontrol olanağı sunuyor. Bu denetim, Skor tablosunun sosyal görünümünü seçmek için collection bağımsız değişkenini kullanın. Öğrenmek için daha fazla bilgi için herkese açık ve sosyal skor tabloları.

Skor tablosundaki arkadaşlar

Sosyal skor tabloları koleksiyonunu uygularsanız, skor tablosu skorları, aşağıdakine benzer bir izin gerektiren çözüm istisnası döndürebilir: bu loadFriends(). Play Games tarafından sağlanan varsayılan kullanıcı arayüzünü (örneğin, getLeaderboardIntent()), bu işlem sizin için otomatik olarak işlenir.

Sonraki adımlar

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