Arkadaşlar

Mevcut oyun içi arkadaş sisteminizi ve oyununuzun erişebileceği diğer sosyal sistemleri tamamlamak ve geliştirmek için Arkadaşlar API'lerini kullanın. Bu sayede oyuncular:

  • Oyununuzda arkadaşlarınızı bulun.

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

  • Play Games'deki arkadaş listelerini oyun içi mevcut arkadaş listeleriyle birleştirebilir.

  • Oyun içi profil pop-up'ı ile başka bir oyuncuyu tanımlayabilirsiniz. Bu pop-up, mevcut oyuncunun arkadaşına verdiği takma adı gösterir. Böylece, oyuncu kimle oynadığını bilir.

Arkadaşları içe aktarma

Temel Bilgiler

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

  • Arkadaşları yükle: 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 profilini görüntüleme: Oturum açmış oyuncunun diğer oyuncuya verdiği adı göstermek için bu görünümü açabilirsiniz. Bu görünümde arkadaşlık yönetimi kontrolleri de sunulur ve oyuncu oyununuzdan çıkarılmaz.
  • Kullanıcı kontrolleri sağlayın: Kullanıcı, Play Games profilinin arkadaşlarına nasıl göründüğünü ve arkadaş listesinin oyunlara nasıl göründüğünü yönetmek için kontrollere sahiptir. Kullanıcı, arkadaş listesi erişimi için tüm oyunlara otomatik olarak erişim izni vermeyi veya her oyun için erişimi ayrı ayrı onaylamayı seçebilir. Sonuç olarak, arkadaş listesi yüklenirken erişim isteği görüntülemek için geri çağırma çağrısı alınabilir.

Play Games arkadaş listesini içe aktarma

Oyuncularınızın Play Games'deki arkadaşlarının listesini almak ve bu oyuncuları oyun içi arkadaş listenize eklemek için Friends API'lerini kullanabilirsiniz.

Yeni kullanıcılar, oynayabilecekleri bir başlangıç arkadaş listesi alır. Mevcut kullanıcılar ise Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilir. Sonuç olarak, kullanıcılarınız birlikte oynayabilecekleri veya rekabet edebilecekleri mümkün olan en büyük oyuncu grubuna sahip olur.

Oyununuza Play Games arkadaşlarını ekleme

Play Games kimliklerini dahili veritabanınızdaki ilgili oyuncu bilgileriyle ilişkilendirerek Play Games arkadaşlarını mevcut oyun içi arkadaş listelerine ekleyin. Bu arkadaşların yanında, Play Games simgesini içeren bir düğme bulunmalıdır. Kullanıcılarınızın arkadaşların kim olduğunu bilmesi için bu düğmeye basıldığında diğer oyuncunun profili gösterilmelidir.

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

Artırılmış arkadaş listesi saklanmıyorsa (ancak yalnızca görüntüleme sırasında kullanılıyorsa) ek işlem yapılmasına gerek yoktur.

Play Games erişimi verme

Oyununuzda Play Games erişimi yoksa kullanıcılardan izin istemek için oyun içi arkadaş listenizi görüntüledikleri zamanı seçebilirsiniz. Örneğin, Play Games arkadaşlarını içe aktar adlı bir düğme ekleyebilirsiniz. Bu düğmeye 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üleme

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

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

Sosyal skor tabloları

Arkadaş API'leri, lider tabloları için de kullanılabilir. Mevcut oyuncunun Play Games arkadaşları arasındaki sıralamasını göstermek için bu özelliği kullanın. Bu özelliğin yalnızca bu bilgileri uygulamanızla paylaşmayı seçen kullanıcılar için geçerli olduğunu ve kullanıcıların Play Games'de arkadaş olması gerektiğini unutmayın. Oyun, bu özelliği desteklemek için kullanıcıya bir kontrol sunar. Bu kontrol, liderlik 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 lider tabloları bölümüne bakın.

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

Sonraki adımlar

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