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, bulut kaydetme sisteminin 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 Oyun Hizmetleri (PGS), oyuncuların sorunsuz bir şekilde oturum açmasını sağlayan otomatik oturum açma özelliğinin yanı sıra tek tıklamayla oturum açma işlemi olan manuel oturum açma özelliğini 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:
- Oyununuzun başlangıç sırası sırasında, oyuncunun otomatik olarak oturum açması için Otomatik oturum açma'yı deneyin.
- Otomatik oturum açma çalışmıyorsa ve kullanıcının cihazı internete bağlıysa Manuel oturum açma'yı deneyin.
- Manuel oturum açma reddedilirse kullanıcının seçimini hatırlayın ve manuel oturum açma seçeneğini tekrar göstermeyin ancak başlatma sırasında otomatik oturum açma seçeneğini 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.
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.
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 deneyimi gösterilerek 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ü kapsamlardan daha fazlasını talep ederseniz otomatik oturum açma işlemi başarılı olamaz. Oyuncuların oyununuzda oturum açmasını sağlamanın en iyi yolu otomatik oturum açma özelliğidir.
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ğini kullanarak kullanıcıların OAuth istemleriyle etkileşime geçmesi gerekmez. Bu da oturum açma zorluğunu azaltı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. PGS, sosyal ağ kimliği ve kendi oyun içi kimlik sisteminizi aynı anda kullanarak oyuncuların oturumunu 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ış oyuncunun yetkisiyle REST API üzerinden doğrudan Play Games Hizmetleri sunucularıyla iletişim kurmasını sağlamak için sunucu kimlik doğrulama kodu isteyebilirsiniz. Bu, oynatıcının kimliğine, profiline ve diğer bilgilerine (yetkilendirilmişse arkadaş listesi gibi) doğrudan erişmenizi 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ğini nasıl uygulayacağınızı öğrenmek için Android Oyunlarında Oturum Açma başlıklı makaleyi inceleyin.