Oturum aç

Google ile Giriş 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 için v2 belgelerine bakın.

Play Games Hizmetleri ile oturum açma, oyunculara 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 ilişki kurulmasına yardımcı olur. Oyuncular, oturum açmak için bu kimliği alternatif merkezi sistemlere kıyasla daha çok 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
  • Oyunu 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 Kayıtlı Oyunlar hizmetini kullanabilirsiniz.

Play Oyun Hizmetleri (PGS), oyuncuların oturum açmasını kolaylaştıran otomatik oturum açma ve tek tıklamayla oturum açma imkanı sunan manuel oturum açma özelliklerini destekler. Bu belgede, 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ını sağlamak için aşağıdaki oturum açma akışını kullanın:

  1. Oyununuzun başlangıç sırası sırasında, oyuncunun oturumunu otomatik olarak açmak 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ı 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ı etkinse (Google Play Games uygulamasında) 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 oturum açma isteği almayı seçebilir.

Otomatik oturum açma

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.

Manuel oturum açma

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ı adına belirli API'leri çağırabilir ve Google Hesabı'nın belirli kısımlarına 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) 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 istekleri 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. Kullanıcılar, yalnızca PGS kapsamlarıyla otomatik oturum açma özelliğini kullanarak herhangi bir OAuth istemiyle etkileşime girmek zorunda kalmaz ve oturum açma zorluğu azalı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, 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. Ayrıca, Android oyuncularına harika bir deneyim yaşatmak için birlikte çalışabilirler.

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 Oyun 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 bir veri 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 o 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.