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 onların arkadaşlarını bulun.
Skor tablolarında skorları arkadaşlarıyla karşılaştırın.
Play Games arkadaşları listesini mevcut oyun içi arkadaş listeleriyle birleştirin.
Başka bir oyuncuyu oyun içi profil pop-up'ı ile tanımlayın. Bu pop-up'ta mevcut oyuncunun arkadaşına verdiği takma ad gösteriliyor. Böylece oyuncu kiminle oynadığını bilir.
Temel Bilgiler
Bu API'ler aşağıdaki işlemleri gerçekleştirmenize olanak tanır:
- Arkadaşları yükle: Oyuncunun oyuna Arkadaş listesi bilgilerine erişme izni verip vermediğini kontrol edebilirsiniz. Erişim izni verilirse oturum açmış oyuncunun arkadaşlarına karşılık gelen Oyuncu nesnelerinin bir listesini alabilirsiniz.
- Başka bir oyuncunun Play Games profilinin görünümünü başlatma: Oturum açmış oyuncu tarafından diğer oyuncuya verilen adı göstermek için bu görünümü açabilirsiniz. Bu görünüm aynı zamanda arkadaşlık yönetimi kontrolleri de sunar ve oyuncuyu oyununuzdan çıkarmaz.
- Kullanıcı kontrolleri sağlama: Kullanıcının, Play Games profilinin arkadaşlarına nasıl görüneceğini ve arkadaş listesinin oyunlar tarafından nasıl görüneceğini yönetmesini sağlayan kontroller vardır. Arkadaş listesi erişimi 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ş listesini yüklerken erişim isteğini görüntülemek için geri arama yapılabilir.
Play Games arkadaş listesini içe aktarma
Oyuncularınızın Play Games arkadaşlarının listesini almak ve onları oyun içi arkadaş listenize eklemek için Friends API'lerini kullanabilirsiniz.
Yeni kullanıcıların oynayabilecekleri bir arkadaşlarının başlangıç listesi olur. Mevcut kullanıcılar da Play Games arkadaşlarını oyun içi arkadaş listelerine aktarabilirler. Bunun sonucunda kullanıcılarınız, oynayabilecekleri veya rekabet edebilecekleri mümkün olan en geniş oyuncu grubuna sahip olur.
Oyununuza Play Games arkadaşları ekleyin
Play Games arkadaşlarınızı 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üğmeniz olduğundan emin olun. Bu düğme, basıldığında diğer oyuncunun profilini gösterir. Böylece kullanıcılarınız arkadaşlarının kimler olduğunu bilir.
Bir arka uç sunucusundaki arkadaş listesini kullanırken listeyi Android API'nin sonucunu iletmek yerine REST API ile güvenli bir şekilde yükleyin. Diğer oyuncuların gördüğü kimlikle tutarlı olması için şu anda oturum açmış durumda olan oynatıcı için REST API'de players.get(me) tarafından döndürülen oynatıcı kimliğini kullandığınızdan emin olun.
Artırılmış arkadaş listesi saklanmadıysa (ancak yalnızca görüntüleme sırasında kullanıldıysa) başka bir işlem yapılması gerekmez.
Play Games'e erişim izni verin
Oyununuzun Play Games'e erişimi yoksa kullanıcılardan oyun içi arkadaş listenizi görüntülediklerinde izin vermelerini istemek için iyi bir zamandır. Örneğin, Play Games arkadaşlarını içe aktar adlı bir düğme ekleyebilirsiniz. Bu düğme, dokunduğunda kullanıcıdan izin vermesini ister. (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çtığınız oyuncunun, başka bir oyuncunun Play Games profilini görüntülemesine izin verebilirsiniz. Bu, oturum açan oyuncunun diğer oyuncuya verdiği adı ve zaten arkadaş olup olmadıklarını görmesini sağlar ve ilişki hakkında ek bilgi verir. Oyuncular henüz arkadaş değilse oturum açmış oyuncu, arkadaşlık yönetimi kontrollerini profil görünümünde görür. Oyun içinden arkadaşlıklar oluşturulduğunda iki oyuncu için varsayılan adlar oyun içi adları olur (bir tane sağlarsanız). Arkadaşlığın başlatıldığı oyunun adı da gösteriliyor.
Sosyal skor tabloları
Friends API'leri skor 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. Bunun yalnızca bu bilgileri uygulamanızla paylaşmayı tercih eden kullanıcılar için geçerli olduğunu ve kullanıcıların Play Games'de arkadaş olduklarını unutmayın. Oyun, bu özelliği desteklemek için 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 skorlarını yükleme çağrısı, loadFriends()'tekine benzer bir izin gerektiren çözümleme istisnası döndürebilir.
Play Games tarafından sağlanan 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
Friends API'larını kullanmaya başlamadan önce aşağıdakileri yapın:
- Bir kod örneğini indirip inceleyin:
- Java
- Unity eklentisini kullanan Unity örnek uygulaması
- Kalite Kontrol Listesi'nde açıklanan önerilere aşina olun.
- Bir Java istemcisinde Friends API'lerini uygulayın.