Oturum aç

Play Games Hizmetleri oturum açma özelliği, oyuncunun oyun kimliğini 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, oturum açmak için bu kimliği alternatif merkezi sistemlere kıyasla daha çok kullanmak ister.

Ayrıca oturum açma özelliği, buluta kaydetme sistemi için anahtar olarak kullanabileceğiniz güçlü ve tutarlı bir tanımlayıcı sağlar. Buluttan oyun kaydetme özelliği, oyunculara aşağıdakileri yapma olanağı tanır:

  • Cihazlarını değiştiren veya sıfırlayan kullanıcılar, kalkıştıkları yerden devam edebilir.
  • Oyunu birden fazla cihazda (ör. başka bir telefonda veya Chromebook'ta) oynama
  • Oyunu kaldırıp daha sonra yeniden yükleme

Play Games Services kimliğini kendi bulut kayıt çözümünüz için anahtar olarak kullanabilir veya ücretsiz Kayıtlı Oyunlar hizmetini kullanabilirsiniz.

Play Games Hizmetleri (PGS), oyuncular için sıfır sorunsuz bir oturum açma yöntemi olan otomatik oturum açmayı ve tek tıklamayla manuel oturum açmayı destekler. Bu dokümanda, bu farklı oturum açma yöntemleri açıklanmaktadır.

Önerilen oturum açma akışı

Oyuncuların oyununuzda başarılı bir şekilde oturum açması için aşağıdaki oturum açma akışını kullanın:

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

Ayrıca, kullanıcıların özel ve kolayca bulunabilen bir düğmeyle oyununuzda Play Games Hizmetleri hesaplarıyla oturum açabilmesini sağlamalısınız.

Otomatik oturum açma

Otomatik oturum açma özelliği, kullanıcıların oyununuzda herhangi bir sorun yaşamadan oturum açmasına olanak tanır. Oyununuz kullanıcının oturum açmasını istiyorsa ve otomatik oturum açma ayarı etkinse (Google Play Games uygulamasında) kullanıcının PGS kimlik 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 istem gösterilmesini seçebilir.

Otomatik oturum açma

Manuel oturum açma

Oyunda otomatik olarak oturum açmayan kullanıcılardan manuel olarak oturum açmalarını isteyebilirsiniz. Kullanıcılar, oyununuzun üst kısmında gösterilen iletişim kutusundan tek tıklamayla oturum açabilir.

Manuel oturum açma

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

PGS kullanılırken kullanıcıların oturum açtıklarını bilmeleri gerekir. Bu işlem, PGS oturum açma deneyimini göstererek yapılır.

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

OAuth Kapsamları ve PGS

PGS, kullanıcıların oyununuza hesaplarına erişim izni vermesine izin vermek için OAuth sisteminden yararlanır. OAuth Kapsamları, geliştirici olarak isteyebileceğiniz izinlerdir. Bu izinler verilirse oyununuz kullanıcı adına belirli API'leri çağırabilir ve Google Hesabının belirli bölümlerine erişmenize olanak tanır.

PGS'nin oyunlar için benzersiz bir kapsamı (games-lite) vardır ve oyununuz kayıtlı oyunlar özelliğini kullanıyorsa başka bir kapsamı (drive.appdata) kullanır. Kayıtlı oyunlar özelliği, oyun verilerinin depolandığı kullanıcının Google Drive hesabına erişim sağlar.

Oyununuz, kullanıcılarınıza mükemmel bir oyun deneyimi sunmak için ihtiyaç duyduğunuz tüm kapsamları isteyebilir. Oyununuz, ihtiyaç duyduğu tüm kapsamları tek bir pakette isteyebilir. Böylece Google Hesabı erişim isteklerinin sayısını sınırlandırabilirsiniz. Ancak bu yaklaşımın önemli bir dezavantajı vardır. PGS'ye özgü daha fazla kapsam isteğinde bulunursanız otomatik oturum açma başarılı olamaz. Oyuncuların oyununuzda oturum açmasını sağlamanın en iyi yolu otomatik oturum açmaktır.

En iyi uygulama, artımlı kapsam istekleri kullanmaktır. Oyununuz ilk istekte önce yalnızca PGS kapsamları istemelidir ve diğer kapsamları daha alakalı bir zamanda ayrı olarak istemelidir.

OAuth erişimi, her kapsam için farklı bir ekran kullanılarak verilir. Bu sayede kullanıcılar, hangi kapsamlara erişim izni vereceğine ayrıntılı bir şekilde karar verebilir. Yalnızca PGS kapsamlarıyla otomatik oturum açma özelliği sayesinde kullanıcıların OAuth istemiyle etkileşim kurması gerekmez. Bu sayede oturum açma sorunları azalır.

Çoklu oturum açma yöntemi desteği

PGS, Android oyuncuları için oyun kimliği sağlar ancak kullanıcılarınıza bağlı tek kimliğin bu olması gerekmez. Oyuncuların oturumunu aynı anda PGS'yi, sosyal ağ kimliğini ve kendi oyun içi kimlik sisteminizi kullanarak oturum açabilirsiniz. Her sistem hem size hem de oyuncularınıza benzersiz bir değer sağlar. Bu sistemlerin tümü birlikte çalışarak Android oyuncularına mükemmel bir deneyim sunabilir.

Arka uç entegrasyonu için oynatıcı kimliğini güvenli bir şekilde alma ve doğrulama

Sunucunuzun, oturum açmış oynatıcının yetkisiyle REST API aracılığıyla doğrudan Play Games Hizmetleri sunucularıyla konuşmasını sağlamak için Sunucu Yetkilendirme kodu isteyebilirsiniz. Bu, oyuncunun kimliğine, profiline ve diğer bilgilerine (yetki verilmişse arkadaş listesi gibi) doğrudan erişim sağlar. Arka uçta oyuncu kimlikleri, arkadaş kimlikleri veya ilgili başka veriler depolıyorsanız bu alanların cihaz tarafında değiştirilme olasılığını ortadan kaldırmak için bu yöntem kullanılmalıdır.

Ayrıca, bazı eski oyunlar ve oyuncular için Android SDK'sı tarafından döndürülen oyuncu kimliği, aynı oyunda bu oyuncuyu görüntüleyen diğer oyuncuların gördüğü kimlikle aynı olmayabilir. Bu durum özellikle arkadaş listesi kullanılırken önemlidir. Ancak 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 için Çevrimdışı erişim ve REST API belgelerine bakın.

İstemci uygulaması

Android'de oturum açma desteğinin nasıl uygulanacağını öğrenmek için Android Games'de oturum açma konusuna bakın.