Oturum aç

Play Games Hizmetleri oturum açma özelliği, oyuncuların oyun kimliği sağlar. Bu kimlik, Android oyuncuları için platform düzeyinde, oyuna özel bir kimliktir. Bu kimlik, oyununuz ile oyuncu arasında bir ilişki kurulmasına yardımcı olur. Oyuncular alternatif bir merkezi sisteme kıyasla oturum açmak için bu kimliği kullanmaya daha isteklidir.

Ayrıca, oturum açma özelliği size bir bulut kayıt sistemi için anahtar olarak kullanabileceğiniz güçlü ve tutarlı bir tanımlayıcı sunar. Buluta kaydetme işlemi son derece değerlidir. Oyuncuların aşağıdakileri yapmasını sağlar:

  • Cihazlarını değiştirir veya sıfırlarlarsa, kaldıkları yerden devam edebilirler
  • Oyunu birden fazla cihazda (ör. başka bir telefonda veya Chromebook'ta) oynayabilirsiniz
  • Oyunu kaldırıp daha sonra yeniden yükleyin

Play Games Hizmetleri kimliğini kendi buluta kaydetme çözümünüzün anahtarı olarak kullanabilir veya ücretsiz Kayıtlı Oyunlar hizmetini kullanabilirsiniz.

Play Games Hizmetleri (PGS), oyuncuların kolayca oturum açmalarını sağlayan otomatik oturum açma özelliğinin yanı sıra tek tıklamayla gerçekleşen bir oturum açma işlemi olan manuel oturum açmayı destekler. Bu dokümanda, farklı oturum açma yöntemleri açıklanmaktadır.

Önerilen oturum açma akışı

Oyuncuların oyununuzda başarıyla oturum açabilmek için aşağıdaki oturum açma akışını kullanın:

  1. Oyununuzun başlangıç sırasında, oyuncunun otomatik olarak oturum açmasını sağlamak için Otomatik oturum açmayı deneyin.
  2. Otomatik oturum açma çalışmıyorsa ve kullanıcının cihazı internete bağlıysa Manuel olarak oturum açmayı deneyin.
  3. Manuel oturum açma reddedilirse kullanıcının seçimini hatırlayın ve manuel oturum açmayı bir kez daha göstermeyin ancak başlangıçta Otomatik Oturum Açma özelliğini kullanmayı deneyin.

Ayrıca, kullanıcıların özel, kolay bulunabilir bir düğmeyle Play Games hizmetleri hesabıyla oyununuzda oturum açabildiğinden emin olmanız gerekir.

Otomatik oturum açma

Otomatik oturum açma, kullanıcıların oyununuzda sorunsuz bir şekilde oturum açmasını sağlar. Böylece otomatik bir şekilde! Oyununuz kullanıcıdan oturum açmasını ve otomatik oturum açma ayarını (Google Play Games uygulamasında) etkinleştirmesini istiyorsa kullanıcının PGS kimlik bilgilerini alırsınız ve kullanıcı PGS oturum açma deneyimini görür.

Otomatik oturum açma, kullanıcıların kontrol edebileceği bir ayardır. Kullanıcılar tüm oyunlarda otomatik olarak oturum açmayı veya her seferinde kendilerine sorulmayı seçebilir.

Otomatik oturum açma

Manuel oturum açma

Kullanıcı oyunda otomatik olarak oturum açmazsa manuel olarak oturum açmasını isteyebilirsiniz. Kullanıcılar, oyununuzun üst kısmında gösterilen iletişim kutusundan tek tıklamayla oturum açabilirler.

Manuel oturum açma

Doğru oturum açma deneyimi için PGS pop-up'larına izin verin

PGS kullanırken kullanıcıların oturum açmış olduklarını bilmesi gerekir. Bunun için PGS oturum açma deneyimi gösterilir.

Oturum açma deneyimini göstermek için oyun başlatırken GamesClient sınıfının setViewForPopups() yöntemini çağırın. Bu, doğru kullanıcı deneyimini sağlamak açısından kritik öneme sahiptir.

OAuth Kapsamları ve PGS

PGS, kullanıcıların oyununuza kendi hesaplarına erişme izni vermelerine imkan tanımak için OAuth sistemini kullanır. OAuth Kapsamları, bir geliştirici olarak isteyebileceğiniz izinlerdir. Bu izinler, oyununuzun kullanıcı adına belirli API'leri çağırmasına ve Google hesabının belirli bölümlerine erişmenize olanak tanır.

PGS oyunlar için benzersiz bir kapsama sahiptir (games-lite) ve oyununuz kayıtlı oyunlar özelliğini kullanıyorsa başka bir kapsama (drive.app_data) dayanır. Kaydedilmiş oyunlar özelliği, oyun verilerinin depolandığı kullanıcının Google Drive hesabına erişim izni verir.

Oyununuz, kullanıcılarınıza mükemmel bir oyun deneyimi sunmak için ihtiyaç duyduğunuz herhangi bir kapsam isteğinde bulunabilir. Oyununuz, gereken tüm kapsamları bir paket halinde isteyebilir. Böylece, Google Hesabı'na erişim isteklerinin sayısını sınırlandırabilir. Ancak bu yaklaşımın dezavantajı büyük bir dezavantaj. PGS'ye özel kapsamlardan daha fazlasını isterseniz otomatik oturum açma başarısız olur. Otomatik oturum açma, oyuncuların oyununuzda oturum açmalarının en iyi yoludur.

En iyi uygulama, ek kapsam istekleri kullanmaktır. Oyununuz ilk istekte ilk olarak yalnızca PGS kapsamlarını, daha alakalı bir zamanda ise diğer kapsamları ayrı ayrı istemelidir.

OAuth erişimi, her kapsam için farklı bir ekran kullanılarak verilir. Bu, kullanıcıların hangi kapsamlara erişeceklerine ayrıntılı olarak karar vermelerine olanak tanır. Otomatik oturum açma özelliğini yalnızca PGS kapsamlarıyla kullandığınızda, kullanıcıların herhangi bir OAuth istemiyle etkileşime geçmesi gerekmez. Bu da oturum açma sorunlarını azaltır.

Çoklu oturum açma yöntemleri için destek

PGS, Android oyuncular için bir oyun kimliği sağlar ancak kullanıcılarınızla bağlantılı tek kimliğin olması gerekmez. PGS, sosyal ağ kimliği ve kendi oyun içi kimlik sisteminizi aynı anda kullanarak oyuncularda oturum açabilirsiniz. Her sistem hem size hem de oyuncularınıza benzersiz bir değer sunar. Hepsi birlikte çalışarak Android oyuncularına mükemmel bir deneyim sunar.

Arka uç entegrasyonu için oyuncu kimliğini güvenli bir şekilde alın ve doğrulayın

Sunucunuzun, doğrudan REST API üzerinden Play Oyun Hizmetleri sunucularıyla, oturum açmış oynatıcının yetkisiyle iletişim kurabilmesi için bir Sunucu Kimlik Doğrulaması kodu isteyebilirsiniz. Bu işlem, oyuncunun kimliğine, profiline ve diğer bilgilere (yetki verildiyse arkadaş listesi gibi) doğrudan erişim sağlar. Arka uçta Oyuncu Kimlikleri, arkadaş kimlikleri veya diğer ilgili verileri depoluyorsanız bu alanların bu alanlarda cihaz tarafı manipülasyonu olasılığını kaldırmak için kullanılması gerekir.

Ayrıca bazı eski oyunlar ve oyuncular için Android SDK'sı tarafından döndürülen oynatıcı kimliği, diğer oyuncuların aynı oyunda o oyuncuyu görüntülerken gördükleri kimlik olmayabilir. Bu, özellikle arkadaşlar listesini kullanırken önemlidir. Bununla birlikte, REST API'de döndürülen player_id her zaman tutarlıdır ve her zaman diğer oyuncular tarafından görülen kimliktir.

Daha fazla bilgi edinmek için Çevrimdışı erişim ve REST API belgelerini inceleyin.

İstemci uygulaması

Android'de oturum açma desteğini nasıl uygulayacağınızı öğrenmek için Android Games'de oturum açma bölümüne göz atın.