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 sayede oyuncular şunları yapabilir:

  • Arkadaşlarınızın oyundaki arkadaşlarını bulabilirsiniz.

  • Skorları arkadaşlarıyla karşılaştırma

  • Kullanıcının Play Games arkadaşlarının listesini, oyundaki mevcut arkadaş listeleriyle birleştirme

  • Oyun içi profil pop-up'ı ile başka bir oyuncuyu tanımlayın. Bu pop-up'ta, mevcut oyuncunun arkadaşına verdiği takma ad gösterilir. Böylece oyuncu, kiminle 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ükleme: Oyuncunun, oyunun arkadaş listesi bilgilerine erişmesine izin verip vermediğini kontrol edebilirsiniz. Erişim izni verilirse kimliği doğrulanmış oyuncunun arkadaşlarına karşılık gelen Player nesnelerinin listesini alabilirsiniz.
  • Başka bir oyuncunun Play Games profilini görüntüleme: Bu görünümü açarak kimliği doğrulanmış oyuncunun diğer oyuncuya verdiği adı gösterebilirsiniz. Bu görünümde arkadaşlık yönetimi kontrolleri de bulunur ve oyuncu oyununuzdan çıkmaz.
  • Kullanıcı kontrolleri sağlama: Kullanıcı, Play Games profilinin arkadaşlarına nasıl görüneceğini ve arkadaş listesinin oyunlara nasıl görüneceğini yönetebilir. Arkadaş listesine erişim için kullanıcı, 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ğini görüntülemek için geri çağırma işlemi yapılabilir.

Play Games arkadaş listesini içe aktarma

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

Yeni kullanıcılar, birlikte oynayabilecekleri bir başlangıç arkadaş listesine sahip olur. Mevcut kullanıcılar ise Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilir. Bu sayede, kullanıcılarınızla birlikte oynayabilecekleri veya karşı yarışabilecekleri en geniş oyuncu grubuna erişebilir.

Oyununuza Play Games arkadaşları ekleme

Play Games arkadaşlarının Play Games kimliklerini dahili veritabanınızdaki ilgili oyuncu bilgileriyle ilişkilendirerek mevcut oyun içi arkadaş listelerine ekleyin. Kullanıcılarınızın arkadaşların kim olduğunu bilmesi için bu arkadaşların yanında Play Games simgesinin bulunduğu bir düğme olduğundan emin olun. Bu düğmeye basıldığında diğer oyuncunun profili gösterilir.

Bir arka uç sunucusundan arkadaş listesini kullanırken Android API'nin sonucunu iletmek yerine REST API'yi kullanarak güvenli bir şekilde yükleyin. Şu anda kimliği doğrulanmış 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ın gördüğü kimlikle tutarlı olacaktır.

Geliştirilmiş arkadaş listesi saklanmıyorsa (yalnızca görüntüleme sırasında kullanılıyorsa) ek bir işlem yapılması gerekmez.

Play Games'e erişim izni verme

Oyununuzda Play Games erişimi yoksa kullanıcılardan izin istemek için uygun bir zaman, oyun içi arkadaş listenizi görüntüledikleri zamandır. Ö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

Kimliği doğrulanmış oyuncunuzun başka bir oyuncunun Play Games profilini görüntülemesine izin verebilirsiniz. Bu sayede, kimliği doğrulanmış oyuncu, diğer oyuncuya verdiği adı ve oyuncular arasında arkadaşlık ilişkisi olup olmadığını görebilir. Böylece, ilişki hakkında daha fazla bilgi edinir. Oyuncular henüz arkadaş değilse kimliği doğrulanmış oyuncu, profil görünümünde arkadaşlık yönetimi kontrollerini görür. Oyun içinden arkadaşlık kurulduğunda iki oyuncunun varsayılan adları, oyun içi adlarıdır (sağlanmışsa). Arkadaşlığın başlatıldığı oyunun adı da gösterilir.

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

Sosyal skor tabloları

Arkadaşlar API'leri, skor tabloları için de kullanılabilir. Bu özelliği kullanarak mevcut oyuncunun Play Games arkadaşları arasındaki sıralamasını gösterin. Bu durumun yalnızca bu bilgileri uygulamanızla paylaşmayı seçen kullanıcılar ve kullanıcılar Play Games'de arkadaşsa geçerli olduğunu unutmayın. Bu özelliği desteklemek için oyun, kullanıcıya bir kontrol sunar. Bu kontrol, 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.

Sosyal skor tabloları koleksiyonunu uygularsanız skor tablosu puanlarını yükleme çağrısı, loadFriends()'daki gibi bir izin gerektiren çözümleme istisnası döndürebilir. Varsayılan Play Games tarafından sağlanan kullanıcı arayüzünü (ör. getLeaderboardIntent()) uygularsanız bu durum sizin için otomatik olarak ele alınır.

Sonraki adımlar

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