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 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'ni 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ı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ı 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 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 nedenle, oyuncuların IGA'ları arasında geçiş yapmasına olanak tanıyan mevcut oyun akışlarınızda herhangi bir değişiklik yapılmaz. Oyuncular hesap değiştirdiğinde PGS aracılığıyla Play Games platformunda kimlik doğrulaması yapmaya devam ederler ve siz de başarımlar ile 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 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ına kimlik doğrulaması yaparken standart Google ile oturum açma 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. 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ılar, SDK başlatma sırasında profil oluşturmaya yönlendirilir.
Profil oluşturma
Oyuncuların platformla etkileşim kurmak için Play Games Hizmetleri profili olması gerekir. Bazı oyuncular, oyununuza başladıklarında Play Games Hizmetleri profiline sahip olmayabilir. Bu oyunculara 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 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 hesabına oyununuzun erişmesine izin vermek 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 kapsama (drive.appdata) bağlıdı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 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. Hedef, sorunsuz bir giriş deneyimi sunmaktı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 ilerlemesini otomatik olarak geri yükler ve oyuncuyu oturum açma ekranını tamamen atlayarak oturum açar.
- 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 konuk hesabı kullanarak oyununuzu başlatıp oynayabilir. Play Games Hizmetleri, oyuncunun arka planda kimlik doğrulamasını yapmaya devam eder. Oyuncu İlerlemeyi Kaydet'i seçerse oyununuz konuk 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 Konuk hesabı başlıklı makaleyi inceleyin.
