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 kullanıcının arkadaşlarını bulma

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

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

  • Oyun içi profil pop-up'ı ile başka bir oyuncuyu belirleyin. 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 yapmanıza 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 Player nesnelerinin listesini alabilirsiniz.
  • Başka bir oyuncunun Play Games profilinin görünümünü başlatma: Bu görünümü açarak oturum açmış oyuncu tarafından diğer oyuncuya verilen adı gösterebilirsiniz. Bu görünümde arkadaşlık yönetimi kontrolleri de bulunur ve oyuncu oyununuzdan çıkmaz.
  • Kullanıcı denetimleri 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. Kullanıcı, arkadaş listesine erişim için tüm oyunlara otomatik olarak erişim izni verebilir veya her oyun için erişimi ayrı ayrı onaylayabilir. Dolayısıyla, arkadaş listesi yüklenirken sonuç, erişim isteğini göstermek için bir geri çağırma olabilir.

Play Games arkadaş listesini içe aktarma

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

Yeni kullanıcılar, birlikte oynayabilecekleri arkadaşların başlangıç listesini görür. Mevcut kullanıcılar ise Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilir. Bu sayede, kullanıcılarınız birlikte oynayabilecekleri veya karşı yarışabilecekleri en geniş oyuncu grubuna sahip olur.

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. 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. Böylece kullanıcılarınız arkadaşların kim olduğunu görebilir.

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 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. 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 henüz 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

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 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 oturum açmış 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 ve Play Games'de arkadaş olan kullanıcılar için 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 leaderboard'lar koleksiyonunu uygularsanız leaderboard puanlarını yükleme çağrısı, loadFriends()'dakiyle benzer bir izin gerekli çözünürlük 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: