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önergelerine uymak 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
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.
Ö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 otomatik olarak tetiklenen profil oluşturma özelliğini uygulayın.
- Otomatik kimlik doğrulama başarısız olursa veya reddederseniz daha sonra kimlik doğrulama yapabilmeniz için manuel oturum açma düğmesi gösterilir.
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 oyununuzda oturum açan 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 Games 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 Games Hizmetleri, bir sosyal ağ kimliği ve kendi oyun içi kimlik sisteminizi kullanarak doğrulayabilirsiniz.
Recall API
Recall API, Google sunucularında geri çağırma jetonlarını 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 başlatılır ve kullanıcıyı kimlik doğrulamaya veya yeni bir hesap oluşturmaya çalışır.
Otomatik kimlik doğrulama başarısız olursa veya reddederseniz daha sonra kimlik doğrulama yapabilmeniz için manuel oturum açma düğmesi gösterilir.
Kimlik doğrulamayı oyun projenize entegre etme hakkında bilgi edinmek için proje türünüzle ilgili dokümanlara 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.