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:

  • Oyununuzda kullanıcının arkadaşlarını bulma

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

  • Kullanıcının Play Games arkadaşlarının listesini, mevcut oyun içi arkadaş listeleriyle birleştirir.

  • 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 yapmanıza 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 Google Play Games profilinin görünümünü başlatma: Bu görünümü açarak kimliği doğrulanmış oyuncu tarafından diğer oyuncuya verilen adı gösterebilirsiniz. Bu görünümde arkadaşlık yönetimi kontrolleri de sunulur ve oyuncu oyununuzdan çıkmaz.
  • Kullanıcı denetimleri sağlama: Kullanıcı, Google 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 geri çağırma olabilir.

Play Oyunlar 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 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. 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ç sunucusundaki arkadaş listesini kullanırken Android API'nin sonucunu iletmek yerine REST API'yi kullanarak listeyi 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 henüz Play Games erişimi yoksa kullanıcılardan izin istemek için iyi 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 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'in sağladığı 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

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