Oyununuzu Google Play Games Hizmetleri ile entegre etmek için önce platform kimlik doğrulamasını uygulayın. Başarılar, skor tabloları ve etkinlikler gibi diğer tüm özelliklere erişmek için bu gereklidir.
Google Play Games Level Up kullanıcı deneyimi yönergelerini karşılamak için oyununuzun önerilen kimlik doğrulama akışına uygun olması gerekir.
Başlatma ve kimlik doğrulama
Oyununuzu başlatmak ve kimliğini 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, başarılar ve skor tabloları gibi Play Oyun Hizmetleri özelliklerine erişmek için zorunlu bir adımdır.
- Kimlik doğrulama, oyun başlatılırken sessiz bir arka plan işlemi olarak çalışır.
Mevcut Play Oyun Hizmetleri kullanıcıları, başarılı kimlik doğrulama işleminden sonra bir karşılama mesajı görür.
Profil oluşturma seçenekleri
Oyuncuların platformla etkileşimde bulunabilmesi için Play Games Hizmetleri profili gereklidir. Bazı oyuncular, oyununuza başladıklarında Play Games Hizmetleri profiline sahip olmayabilir. Bu oyunculardan hesap 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 profil oluşturma istemleri varsayılan olarak otomatik şekilde gösterilir.
Oyun başlattığınızda profil oluşturma istemi (büyütmek için tıklayın). Lansmanda profil oluşturma istemlerini devre dışı bırakma ve oyun başlatıldıktan sonra manuel istemler ekleme Manifest dosyası aracılığıyla otomatik olarak tetiklenen profil oluşturma istemlerini devre dışı bırakabilirsiniz. Bu sayede Play Games Hizmetleri profili olmayan kullanıcılar, Play Games Hizmetleri profili oluşturmaları için hemen istem almadan uyguladığınız kimlik doğrulama yöntemleriyle devam edebilir.
Kullanıcılar herhangi bir kimlik sağlayıcıyla oturum açabilir ancak Play Games Platformu'na kaydolmayı teşvik etmek için Kimlik doğrulama sonucunu alın bölümünde açıklandığı gibi bir profil oluşturma istemi başlatmanızı öneririz. Bu istemi istediğiniz zaman tetikleyebilirsiniz ancak kullanıcılar başarılar ve skor tabloları gibi özelliklerde önemli ilerleme kaydetmeden önce tetiklendiğini doğrulayın.
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.
Önerilen kimlik doğrulama akışı
Google Play Games Level Up kullanıcı deneyimi yönergelerini karşılamak için oyuncu devamlılığı şartlarına uyduğunuzu doğrulayın. Oyuncuların oyununuzda oturum açmasını sağlamak için aşağıdaki kimlik doğrulama akışını kullanın:
- Oyununuzun başlangıç sırası sırasında profil oluşturma seçeneklerini inceleyin ve bir seçenek belirleyin.
- Otomatik oturum açma çalışmıyorsa veya kullanıcı reddediyorsa daha sonra oturum açmak istemesi ihtimaline karşı manuel oturum açma düğmesi gösterin.
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 Oyun 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.
OAuth Kapsamları
Play Oyun 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 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 Oyun 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.
Birden fazla kimlik doğrulama hizmeti
Play Oyun Hizmetleri, Android oyuncularına oyun kimliği sağlar ancak kullanıcılarınıza bağlı tek kimlik olması gerekmez. Oyuncuların kimliğini aynı anda Play Oyun Hizmetleri, bir sosyal ağ kimliği ve kendi oyun içi kimlik sisteminizi kullanarak doğrulayabilirsiniz.
Recall API
Recall API, Google sunucularında hatırlatma jetonları depolayarak oyunların PGS kullanıcıları ile oyun içi hesapları arasındaki bağlantıları yönetmesine olanak tanır. Bu özelliği etkinleştirme hakkında daha fazla bilgi edinmek için PGS Recall API'yi oyununuza entegre etme başlıklı makaleyi inceleyin.
Oyun istemcisi entegrasyonu
Kimlik doğrulamayı oyun projenize entegre ederken aşağıdaki kullanıcı akışını öneririz:
Oyununuzun başlangıç sırası sırasında, profil oluşturma seçenekleri başlatılır ve kullanıcının oturum açması veya yeni bir hesap oluşturması denenir.
Otomatik kimlik doğrulama çalışmazsa veya kullanıcı reddederse kullanıcının daha sonra giriş yapmak istemesi ihtimaline karşı manuel oturum açma düğmesi gösterilir.
Oyun projenize kimlik doğrulama entegre etme hakkında bilgi edinmek için proje türünüze yönelik başlangıç kılavuzuna bakın:
Oyun sunucusu entegrasyonu
Oyuncunun kimliğinin doğrulandığını onayladıktan sonra requestServerSideAccess numaralı telefonu arayarak sunucu yetkilendirme kodu alabilirsiniz. Doğrudan Play Games Hizmetleri sunucularıyla iletişim kurmak için bu sunucu yetkilendirme kodunu arka uç oyun sunucunuza iletin. Bu iletişim, sunucunuzun aşağıdakiler dahil olmak üzere oyuncu verilerine erişmesine olanak tanır:
- Oyuncu Kimliği
- Profil
- Arkadaş listesi
- Oyundaki ilerleme durumu
- Başarılar
Ardından sunucunuz, Play Oyun Hizmetleri sunucularıyla güvenli bir şekilde etkileşim kurmak için bu yetkilendirme kodunu REST API ile birlikte kullanır. Daha fazla bilgi için Play Games Hizmetleri'ne sunucu tarafında erişim başlıklı makaleyi inceleyin.
Giriş isteği kotası
Play Oyun Hizmetleri ile giriş istekleri için günlük kota vardır. Daha fazla bilgi için Günlük kotanızı yönetme başlıklı makaleyi inceleyin.