Oyununuzu Google Play Games Hizmetleri (PGS) ile entegre etmenin ilk adımı, platform kimlik doğrulamasını uygulamaktır. Başarılar, skor tabloları ve etkinlikler gibi diğer tüm özelliklere erişmek için bu adım gereklidir.
Play Games Hizmetleri SDK'sı, oyun başlatılırken platform kimlik doğrulamasını otomatik olarak gerçekleştirdiğinden, oyununuzun Google Play Games Level Up kullanıcı deneyimi yönergelerini uygulamaya ve karşılamaya hazır olması için PGS v2 SDK'sını oyununuza entegre etmeniz ve önerilen kimlik doğrulama akışını uygulamanız gerekir.
Kimlik doğrulama kavramları
Play Games Hizmetleri v2'de "oturum açma" kavramı iki ayrı katmana ayrılmıştır: platform kimlik doğrulaması ve oyun içi kimlik doğrulaması.
Platform kimlik doğrulaması
Play Games Hizmetleri, platform etkileşimi katmanı sağlar. Başarılar, skor tabloları ve görevler gibi özelliklere erişmek için oyuncu profili kullanarak oyuncunuzun Google Play Games ekosistemiyle ilişkisini yönetir. Platform kimlik doğrulama aşağıdaki temel özelliklere sahiptir:
- Sessiz ve otomatik: Oyun başlatıldığında kimlik doğrulama otomatik olarak arka planda gerçekleşir. Play Oyun Hizmetleri'nde manuel Oturum aç düğmesi gerekmez.
- Oyuncu kimliği: Platform kimlik doğrulaması başarılı olduktan sonra Play Games Hizmetleri, sabit bir oyuncu kimliği sağlar. Bu kimlik, aynı oyunda cihazlar arasında tutarlıdır. Bu kimliği öncelikli olarak başarı ilerleme durumu gibi platform özelliklerini izlemek için kullanın.
- Ayrılmış: Oyuncunuzun oyun içi hesabını (IGA), oyun ilerlemesini veya envanterini yönetmek için oyununuzun birincil kimlik sistemi olarak Play Oyun Hizmetleri'ni kullanmamalısınız. Play Oyun Hizmetleri, kalıcı bir platform tanımlayıcısı olarak işlev görür.
Oyuncu Kimliği
Oyuncu kimliği, Play Games Hizmetleri oyuncu hesabının tanımlayıcısıdır. Oyununuz, Play Games Hizmetleri kimlik doğrulamasını kullanarak oyununuza giriş yapan tüm oyuncular için oyuncu kimliği alabilir. Oyun istemcisi entegrasyonunuz, oyun sunucusu entegrasyonunuz ve buluta kaydetme hizmetiniz, Play Games Hizmetleri'ndeki oyuncu verilerine güvenli bir şekilde erişmek için kimliği kullanabilir.
Oyuncu kimliği, kullanıcının oyununuzu birden fazla cihazda oynadığı durumlarda aynı kalır. Ancak bu durum oyunlar arasında her zaman tutarlı değildir. Daha fazla bilgi için Yeni nesil oyuncu kimlikleri başlıklı makaleyi inceleyin.
Oyun içi kimlik doğrulama
Oyun içi hesabı (IGA) yönetirsiniz. Bu, oyununuzdaki oyuncu ilerlemesini, envanteri ve para birimini bağlayan kimlik sistemidir.
- Birincil Kimlik: Birincil oturum açma yöntemi olarak kendi arka uç sisteminizi, Google ile Oturum Açma'yı (SiWG) veya diğer sağlayıcıları kullanabilirsiniz.
- Bağımsızlık: Oyuncular, belirli bir IGA'da (ör. konuk hesabı veya belirli bir SiWG hesabı) oturum açmışken başarı kazanmak için Play Games Hizmetleri'nde (Platform Kimliği) oturum açabilir.
- Birden fazla IGA'nın yönetimi: Play Games Hizmetleri yalnızca platform kimlik doğrulamasını işler. Oyuncuların IGA'larındaki birincil kimlik doğrulama, oyununuz tarafından yönetilir. Bu nedenle, oyuncuların IGA'ları arasında geçiş yapmasına yönelik oyununuzdaki mevcut akışlarda herhangi bir değişiklik olmaz. Oyuncular hesap değiştirdiğinde PGS aracılığıyla Play Games platformunda kimlikleri doğrulanmış olarak kalır ve başarımlar ile diğer PGS özellikleriyle ilgili verileri kalıcı oyuncu kimliği ile karşılaştırarak göndermeye devam edersiniz.
SiWG ile platformlar arası süreklilik
Oyuncuların ilerlemelerini Android, iOS ve web'de taşımasına yardımcı olmak için Google ile oturum açma'yı birincil oyun içi kimlik doğrulama yöntemi olarak kullanın. Aşağıdakileri göz önünde bulundurun:
- Google ile oturum açma düğmesi: PGS v1'de Google Play düğmesi genellikle hem platform hem de oyun oturum açma işlemlerini gerçekleştiriyordu. v2'de bunlar ayrı işlemlerdir. Oyuncuların kimliklerini doğrulamak ve IGA'larına erişmek için standart bir Google ile oturum açma düğmesi uygulayın.
- Google ile Giriş SDK'ları:
- Hem Android hem de iOS için oyuncuların IGA'larında kimliklerini doğrulamak üzere standart Google ile oturum açma SDK'larını kullanın.
- Oyuncunun oyun içi hesabının birincil tanımlayıcısı olarak Google Open ID'yi kullanın.
- Başarılar gibi Play Games özelliklerindeki oyuncu ilerlemesini bildirmek için Play Games Hizmetleri oyuncu kimliğini kullanın.
Önerilen entegrasyon
Oyununuzu Play Games Hizmetleri ile entegre etmek için önerilen şu adımları uygulayın:
Başlatma ve kimlik doğrulama
Oyununuzu başlatmak ve kimliğinizi doğrulamak için bu adım gereklidir:
Başlangıçta Play Games Hizmetleri v2 SDK'sını başlatarak platform kimlik doğrulamasını uygulayın. Daha fazla bilgi için Android oyunlarında platform kimlik doğrulaması başlıklı makaleyi inceleyin. Bu adım, başarılar ve skor tabloları gibi Play Oyun Hizmetleri özelliklerine erişmek için gereklidir.
Kimlik doğrulama, oyun başlatılırken sessiz bir arka plan işlemi olarak çalışır. Mevcut Play Games Hizmetleri kullanıcıları, kimlik doğrulama başarılı olduktan sonra bir karşılama mesajı görür. Play Games Hizmetleri profili olmayan kullanıcılardan SDK başlatma sırasında profil oluşturmaları istenir.
Profil oluşturma
Oyuncuların platformla etkileşim kurabilmesi için Play Games Hizmetleri profili gerekir. Bazı oyuncular, oyununuza başladıklarında Play Games Hizmetleri profiline sahip olmayabilir. Bu oyunculardan profil oluşturmaları istenir. Aşağıdaki seçeneklerden birini belirleyerek kullanıcılarınız için doğru deneyime karar verebilirsiniz:
Otomatik olarak tetiklenen profil oluşturma istemleri
Play Games Hizmetleri profili olmadan bir oyun başlattığınızda otomatik olarak tetiklenen profil oluşturma istemleri varsayılan olarak otomatik şekilde gösterilir.
Otomatik olarak tetiklenen profil oluşturma istemlerini durdurma
Manifest dosyasını, otomatik olarak tetiklenen istemeleri engelleyecek şekilde yapılandırarak başlatma sırasında profil istemlerini devre dışı bırakın. Bu sayede Play Games Hizmetleri profili olmayan kullanıcılar, Play Games Hizmetleri profili oluşturmaları istenmeden oyunu yüklemeye devam edebilir.
Kullanıcılar herhangi bir kimlik sağlayıcıyla oturum açabilir ancak Play Games platform kimlik doğrulamasıyla kimlik doğrulamalarını teşvik etmek için profil oluşturma istemi göstermeniz gerekir. Bu istemi gerektiği gibi gösterin ancak kullanıcıların başarılar ve skor tabloları gibi özelliklerde önemli ilerleme kaydetmeden önce gösterdiğinizden emin olun.
Profil istemini aşağıdaki önerilen anlarda tetiklemeyi düşünebilirsiniz:
- Bir eğitimi tamamladıktan sonra
- Ödül kazanma anında (örneğin, maç kazanma, nadir bir öğe toplama veya dönüm noktasına ulaşma).
- İkinci bir oturum başlatılırken.
Daha fazla bilgi için Otomatik olarak tetiklenen profil oluşturmayı önleme (Java) ve Otomatik olarak tetiklenen profil oluşturmayı önleme (Unity) başlıklı makaleleri inceleyin.
Oyun içi kimlik doğrulama
Platform kimlik doğrulaması başarıyla gerçekleştirildikten sonra geliştiriciler, oyuncuların mevcut oyun durumuna bağlı olarak IGAs'lerine erişebilmesi için aşağıdaki adımları uygulamalıdır:
- Cihazda etkin bir oyun oturumu varsa oyuncunun mevcut oturumuna devam etmesine izin verin.
- Etkin bir oyun oturumu yoksa:
- Son oynanan IGA'nın PGS Player ID ile ilişkilendirildiği sorunsuz geri yükleme senaryosunda, ilişkili IGA'yı otomatik olarak geri yüklemeye devam edin.
- Aksi takdirde, oyuncuya uygulamanızın belirlenmiş giriş veya hesap oluşturma ekranını gösterin. Oyuncular daha sonra tercih ettikleri kimlik doğrulama yöntemini seçerek yeni bir IGA oluşturabilir veya mevcut bir IGA'ya giriş yapabilir.
OAuth kapsamları
Play Games Hizmetleri, oyuncuların oyununuza hesaplarına erişim izni vermesi için OAuth sistemini kullanır. 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) kullanır. Kayıtlı oyunlar özelliği, oyun verilerinin depolandığı kullanıcının Google Drive hesabına erişim sağlar.
Play Games Hizmetleri v2 SDK'sını kullanırken ek OAuth kapsamları isteyebilirsiniz.
Ekstra OAuth kapsamlarına ihtiyacınız varsa requestServerSideAccess numaralı telefonu aramanızı öneririz.
Daha fazla bilgi için Sunucu yetkilendirme kodunu alma veya Sunucu yetkilendirme kodlarını alma başlıklı makaleleri inceleyin.
İdeal kimlik doğrulama akışı için kullanıcı deneyimi yönergesi
Aşağıdaki yönergelerde, PGS v2 entegrasyonuyla önerilen kimlik doğrulama akışı açıklanmaktadır. Yeni, mevcut ve geri gelen kullanıcılar ile misafir modu için senaryoları kapsar.
Yeni oyuncu
Bu akış, oyunu daha önce oynama geçmişi olmayan bir cihazda ilk kez başlatan kullanıcılar için geçerlidir.
- PGS SDK, başlatıldığında kullanıcının platform kimliğini (PGS Oyuncu Kimliği) doğrulamak için başlatılır.
- Bu arka plan el sıkışmasından sonra oyun, oyuncuya IGA oluşturma seçeneklerini gösterir. Örneğin, Yeni hesap oluştur, Google ile oturum aç veya diğer sosyal oturum açma yöntemleri.
- Oyuncu bir IGA oluşturduktan veya seçtikten sonra oyun, bu hesabı arka uçtaki seçilen birincil tanımlayıcıya bağlar.
- Oyun, bu seçilen IGA'yı PGS oyuncu kimliğine de bağlar ve sorunsuz geri yükleme için son oynanan IGA olarak işaretler.
Etkin oturumları olan oyuncular
Bu senaryoda, oyuncuların oyunu halihazırda etkin bir oturumlarının olduğu bir cihazda başlattığı açıklanmaktadır. Amaç, sorunsuz bir giriş deneyimi sağlamaktır.
- Oyuncu uygulamayı başlattığında PGS, arka planda sessizce kimlik doğrulaması yaparak başarılar ve diğer Play Games özelliklerine karşı ilerlemeyi izlemek için size oyuncu kimliği sağlar.
- Aynı zamanda, geçerli olduğu durumlarda oyun, giriş ekranlarını atlar ve oyuncuyu etkin IGA oturumuna veya Oyuncu Kimliği ile ilişkili son oynanan IGA'ya hemen kaydeder. Böylece oyuncu, oyuna hemen devam edebilir.
Hesap değiştiren oyuncular
Bu akış, etkin bir oturumu olan oyuncu hesap değiştirmek için oyun ayarlarına gittiğinde gerçekleşir. Örneğin, alternatif bir hesap kullanmak için ana hesabın oturumunu kapatma.
- Oyuncu, mevcut IGA'dan çıkış yapar ancak PGS platformu bağlantısı etkin kalır.
- Oyuncu farklı bir IGA ile giriş yaptığında oyun, bu yeni hesabı yalnızca sorunsuz geri yükleme için son oynanan IGA olarak mevcut PGS oyuncu kimliğine bağlar.
Geri dönen oyuncular için sorunsuz geri yükleme
Bu senaryo, oyuncu oyunu etkin olmadığı bir dönemden sonra, yeniden yükledikten sonra veya tamamen yeni bir cihazda başlattığında geçerlidir. Oyunda sorunsuz geri yükleme özelliğinin uygulanması önerilir.
- PGS, başlatıldığında kullanıcının kimliğini doğrular ve oyuna PGS oyuncu kimliğini sağlar.
- Oyun, son oynanan IGA'nın bu PGS kimliğine zaten bağlanıp bağlanmadığını görmek için arka ucunu (veya Recall API kullanılıyorsa alınan çağırma jetonunu) kontrol eder.
- Bir bağlantı bulunursa oyun, oyuncunun ilerleme durumunu otomatik olarak geri yükler ve oyuncuyu tamamen manuel giriş ekranını atlayarak giriş yapar.
- Aksi takdirde, oyuncuya giriş ekranı gösterilir.
- Oyuncu daha sonra bir giriş yöntemi seçer ve IGA'da oturum açar.
- Ardından oyun, sorunsuz geri yükleme için bu IGA'yı PGS oyuncu kimliğiyle son oynanan IGA olarak bağlar.
Misafir modu
Oyuncular, yerel bir misafir hesabı kullanarak oyununuzu başlatıp oynayabilir. Play Games Hizmetleri, oyuncuyu arka planda kimlik doğrulamaya devam eder. Oyuncu İlerlemeyi Kaydet'i seçerse oyununuz misafir oturumunu kalıcı bir IGA'ya dönüştürür ve oyuncu kimliğine bağlar. Çakışma çözümü hakkında daha fazla bilgi için Misafir hesabı başlıklı makaleyi inceleyin.
