Google ile Oturum Açma API'sinin desteğinin sonlandırılmasının ardından, 2026'da Games v1 SDK'sını kaldırıyoruz. Şubat 2025'ten sonra games v1 SDK'sıyla yeni entegre edilen oyunları Google Play'de yayınlayamayacaksınız. Bunun yerine games v2 SDK'sını kullanmanızı öneririz.
Önceki Games v1 entegrasyonlarına sahip mevcut uygulamalar birkaç yıl daha çalışmaya devam edecek olsa da
Haziran 2025'ten itibaren
v2'ye geçiş yapmanız
önerilir.
Bu kılavuz, Play Games Hizmetleri v1 SDK'sının kullanımıyla ilgilidir. En son SDK sürümü hakkında bilgi edinmek için v2 belgelerine bakın.
Google Play Games Hizmetleri ile oturum açma, 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 ilişki kurulmasına yardımcı olur. Oyuncular, oturum açmak için bu kimliği alternatif merkezi sistemlere kıyasla daha fazla kullanır.
Ayrıca oturum açma işlemi, buluta kaydetme sisteminin anahtarı olarak kullanabileceğiniz güçlü ve tutarlı bir tanımlayıcı sağlar. Bulut kaydı, oyuncular için çok değerlidir ve aşağıdakileri yapmalarını sağlar:
- Cihazlarını değiştirirlerse veya sıfırlarlarsa kaldıkları yerden devam etmelerini sağlama
- Oyunu birden fazla cihazda (ör. başka bir telefonda veya Chromebook'ta) oynama
- Oyunun yüklemesini kaldırıp daha sonra yeniden yükleme
Play Games Hizmetleri kimliğini kendi bulut kaydetme çözümünüz için anahtar olarak kullanabilir veya ücretsiz Kaydedilmiş Oyunlar hizmetini kullanabilirsiniz.
Play Oyun Hizmetleri (PGS), oyuncuların oturum açmasını sağlayan sıfır sürtünmeli bir yöntem olan otomatik oturum açmanın yanı sıra tek tıklamayla oturum açma işlemi olan manuel oturum açmayı da destekler. Bu belgede, oturum açma için kullanılan farklı yöntemler açıklanmaktadır.
Önerilen oturum açma akışı
Oyuncuların oyununuzda başarılı bir şekilde oturum açmasını sağlamak 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çmayı tekrar göstermeyin. Bunun yerine, başlatma sırasında otomatik oturum açmayı denemeye devam edin.
Ayrıca, kullanıcıların Play Oyun Hizmetleri hesaplarıyla oyununuzda oturum açabilmesi için özel ve kolayca bulunabilen bir düğme eklemeniz gerekir.
Otomatik oturum açma
Otomatik oturum açma özelliği, kullanıcıların oyununuzda sorunsuz bir şekilde oturum açmasına olanak tanır. Oyununuzda kullanıcının oturum açması isteniyorsa ve otomatik oturum açma ayarı (Google Play Games uygulamasında) etkinse 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 sorulmayı tercih edebilir.
Manuel oturum açma
Kullanıcı oyunda otomatik olarak oturum açmıyorsa manuel olarak oturum açmasını isteyebilirsiniz. Kullanıcılar, oyununuzun üst kısmında gösterilen bir iletişim kutusundan tek tıklamayla oturum açabilir.
Doğru oturum açma deneyimi için PGS pop-up'larına izin verin
Kullanıcıların PGS'yi kullanırken oturum açmış olması 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 hesabına oyununuzun erişmesine izin vermek için OAuth sistemini kullanır. OAuth Kapsamları, geliştirici olarak isteyebileceğiniz izinlerdir. Bu izinler verilirse oyununuz kullanıcının adına belirli API'leri çağırabilir ve Google Hesabı'nın belirli kısımlarına erişmenize olanak tanır.
Google Play Games Hizmetleri'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) temel alı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 harika bir oyun deneyimi sunmak için ihtiyaç duyduğunuz tüm kapsamları isteyebilir. Oyununuz, Google Hesabı erişimi için istek sayısını sınırlayarak ihtiyaç duyduğu tüm kapsamları tek bir pakette isteyebilir. Ancak bu yaklaşımın büyük bir dezavantajı vardır. PGS'ye özgü kapsamların dışında bir kapsam isteğinde bulunursanız otomatik oturum açma işlemi başarılı olmaz. Otomatik oturum açma, oyuncuların oyununuzda oturum açmasını sağlamanın en iyi yoludur.
En iyi uygulama, artımlı kapsam isteklerini kullanmaktır. Oyununuz, ilk istekte yalnızca PGS kapsamlarını istemeli ve diğer kapsamları daha uygun 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 vereceklerine ayrıntılı bir şekilde karar verebilir. Yalnızca PGS kapsamlarıyla otomatik oturum açma özelliğini kullanarak kullanıcıların herhangi bir OAuth istemiyle etkileşime girmesi gerekmez. Bu sayede oturum açma zorluğu azaltılır.
Birden fazla oturum açma yöntemi desteği
PGS, Android oyuncularına oyun kimliği sağlar ancak kullanıcılarınıza bağlı tek kimlik olması gerekmez. Oyuncuların oturum açması için aynı anda PGS, bir sosyal ağ kimliği ve kendi oyun içi kimlik sisteminizi kullanabilirsiniz. Her sistem hem sizin hem de oyuncularınız için benzersiz bir değer sunar ve tüm sistemler, Android oyuncularına harika bir deneyim yaşatmak için birlikte çalışabilir.
Arka uç entegrasyonu için oyuncu 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 yetkilendirme kodu isteyebilirsiniz. Bu sayede oyuncunun kimliğine, profiline ve diğer bilgilerine (ör. yetkilendirilmişse arkadaş listesi) doğrudan erişilebilir. Arka uçta herhangi bir oyuncu kimliği, arkadaş kimliği veya ilgili başka veriler depoluyorsanı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 bir oyuncuya ait 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 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.