Oyununuzu Google Play Oyun 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 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ğrulama.
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 profilini kullanarak oyuncunuzun Google Play Games ekosistemiyle ilişkisini yönetir. Platform kimlik doğrulamasının temel özellikleri şunlardır:
- Sessiz ve otomatik: Oyun başlatıldığında kimlik doğrulama arka planda otomatik olarak gerçekleşir. Play Oyun Hizmetleri'nde manuel Oturum aç düğmesi gerekmez.
- Oyuncu kimliği: Platform kimlik doğrulaması başarıyla tamamlandıktan 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ı ilerlemesi 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 Games Hizmetleri'ni kullanmamalısınız. Play Games Hizmetleri, kalıcı bir platform tanımlayıcısı olarak hizmet verir.
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ı gerçekleştirir. Oyununuz, oyuncuların IGA'larına birincil kimlik doğrulamasını yönetir. Bu, oyuncuların IGA'ları arasında geçiş yapmasına olanak tanıyan mevcut akışlarda herhangi bir değişiklik olmadığı anlamına gelir. Oyuncular hesap değiştirdiğinde PGS aracılığıyla Play Games platformunda kimlik doğrulaması yapmaya devam ederler ve siz de başarımlarla ve diğer PGS özellikleriyle ilgili verilerini 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 birincil oyun içi kimlik doğrulama yöntemi olarak Google ile oturum açma'yı 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ğrulamaları ve IGA'larına erişmeleri 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 kimlik doğrulaması yapmasını sağlamak üzere standart Google ile Giriş SDK'larını kullanın.
- Google Open ID'yi, oyuncunun oyun içi hesabının birincil tanımlayıcısı olarak 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 aşağıdaki önerilen 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. Başarılar ve skor tabloları gibi Play Oyun Hizmetleri özelliklerine erişmek için bu adım 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ılar, SDK başlatma sırasında profil oluşturmaya yönlendirilir.
Profil oluşturma
Oyuncuların platformla etkileşim kurabilmek için Play Games Hizmetleri profili olması gerekir. Bazı oyuncular, oyununuza başladıklarında Play Games Hizmetleri profiline sahip olmayabilir. Bu oyunculardan hesap oluşturmaları istenir.
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.
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 IGA'larına 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 mevcut bir IGA oluşturmak veya IGA'ya giriş yapmak için tercih ettikleri kimlik doğrulama yöntemini seçebilir.
OAuth kapsamları
Play Games Hizmetleri, oyuncuların hesabı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) temel alı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 kimlik doğrulama kodunu alma veya sunucu kimlik doğrulama 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 giriş 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 son oynanan ve oyuncu kimliğiyle ilişkili 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 Recall jetonunu) kontrol eder.
- Bir bağlantı bulunursa oyun, oyuncunun ilerlemesini otomatik olarak geri yükler ve oyuncuyu tamamen manuel giriş ekranını atlayarak giriş yapar.
- Aksi takdirde, oyuncuya giriş ekranı gösterilir.
- Ardından oyuncu 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, oyunu yerel bir misafir hesabı kullanarak başlatıp oynayabilir. PGS, arka planda kimlik doğrulamaya devam eder. Oyuncu İlerlemeyi Kaydet'i seçerse oyun, konuk oturumunu kalıcı bir IGA'ya dönüştürür ve bunu PGS oyuncu kimliğine bağlar.
