Google Play Oyun Hizmetleri, games v1 SDK'sı, desteği sonlandırılan ve 2025'te Google Play Hizmetleri Kimlik Doğrulama SDK'sından (com.google.android.gms:play-services-auth) kaldırılacak olan Android için Google ile oturum açma özelliğini kullanır.
Yeni oyun uygulamaları, 2025'e kadar Games v1'i kullanabilir. Google ile Oturum Açma özelliğinin kaldırılması, mevcut oyun uygulamalarında bağımlılık sorunları ortaya çıkarıyor. Mevcut oyun uygulamalarını games v1 SDK'sından games v2 SDK'sına taşımak, Google ile oturum açma özelliğinin kaldırılmasıyla ortaya çıkan bağımlılık sorunlarını çözer.
Bu doküman, oyun uygulaması ile çeşitli SDK'lar arasındaki etkileşimleri anlamanıza yardımcı olur. Bu belgede, uygulamanın özellikleri Play Games Hizmetleri games v1 ve games v2 SDK'larının özellikleriyle de karşılaştırılmaktadır.
SDK etkileşimleri
Şemalar, Android'deki bir oyun uygulaması, Google Mobil Hizmetleri (GMS) Core, Play Oyun Hizmetleri ve üçüncü taraf (3. taraf) oyun sunucusu arasındaki etkileşimi göstermektedir. Bu raporda, uygulamanın kimlik doğrulama ve oyun özellikleri için Google'ın hizmetlerini nasıl kullandığı ve aynı zamanda ayrı bir üçüncü taraf sistemiyle nasıl etkileşime geçtiği vurgulanmaktadır.
games v2 (Mevcut)
games v1 (Eski)
Bileşenlere ve SDK'lara kısa bir genel bakış aşağıda verilmiştir:
- Oyun Uygulaması.
- Bu, kullanıcının Android destekli bir cihazda çalışan oyun uygulamasını temsil eder.
- İki ana bileşenden oluşur:
- games v1 veya games v2 SDK'sı Play Games Hizmetleri ile etkileşimden sorumlu istemci tarafı SDK'sı.
- Auth SDK'sı. Google Play Hizmetleri Auth SDK'sı, games v1'de kullanıcı kimlik doğrulama ve yetkilendirme akışlarını yönetmekten sorumludur.
- Her iki SDK da AIDL (Android Arayüz Tanımlama Dili) kullanarak iletişim kurar. Bu, farklı işlemler veya hizmetler arasındaki bir iletişim kalıbını gösterir.
- GMS Core, Google Play Hizmetleri olarak da bilinir.
- Bu, Android'deki Google'a ait katmandır.
- Oyunlar uygulaması iki GMS Core modülü kullanır:
- Oyunlar modülü: Skor tabloları, başarılar ve oyun durumu yönetimi gibi oyuna özgü özellikleri sağlar.
- Auth Modülü. Kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetir.
- Oyunlar uygulamasındaki Oyunlar ve Kimlik doğrulama SDK'ları, AIDL arayüzlerini kullanarak ilgili modüllerle iletişim kurar. Bu arayüzler, işlemler arası iletişimi (IPC) gösterir.
- Play Games Hizmetleri ağ geçidi.
- GMS Core ile Play Oyun Hizmetleri sunucusu arasındaki iletişimi sağlayan mantıksal bir ağ geçidi.
- Sunucu iletişimi için API isteklerini, veri dönüşümünü ve kimlik doğrulamayı yönetir.
- Play Games Hizmetleri sunucusu.
- Oyun verilerini depolama, kullanıcı hesaplarını yönetme ve çok oyunculu özellikleri kolaylaştırmadan sorumlu Play Oyun Hizmetleri arka uç hizmetlerini temsil eder.
- Üçüncü taraf oyun geçidi.
- Oyun uygulamanız üçüncü taraf (3. taraf) uygulama olarak kabul ediliyorsa istemci kitaplığı, üçüncü taraf oyun sunucuları üzerinden Play Oyun Hizmetleri sunucularıyla iletişim kurar.
- Uygulamanın farklı bir servis sağlayıcıyla da kimlik doğrulaması yapabileceğini belirtir.
- Üçüncü taraf oyun sunucusu.
- Oyun uygulamasının etkileşimde bulunabileceği isteğe bağlı bir harici sunucuyu temsil eder. Bu sunucu, büyük olasılıkla özel özellikler veya veri yönetimi için kullanılır.
- Uygulamayla iletişim, üçüncü taraf oyun ağ geçidi üzerinden gerçekleşir.
Özellik karşılaştırması
Bu tabloda, Games v1 ve Games v2 SDK'ları arasındaki özellik karşılaştırması gösterilmektedir:
Özellik |
games v1 SDK |
games v2 SDK |
|---|---|---|
Kimlik doğrulama |
play-services-auth ile entegrasyon gereklidir. |
Basitleştirilmiş ve kolaylaştırılmış; play-services-auth gerekmez. |
Yetkilendirme |
Başarılı, başarısız ve yeniden deneme işlemleri için ek kod. |
SDK tarafından yönetilir |
Sunucu Erişimi Jetonu |
GoogleSigninClient ile ek OAuth 2.0 kapsamları isteyebilir.Oturum açma sırasında hata işleme için ek kod. |
Ek kapsamlara izin verilmez. serverAuthcode ile başarı/başarısızlık geri çağırma işlevi içeren ek kod. |
Oturum açma işlemi |
GoogleSigninClient kullanır.Otomatik oturum açma ve hata işleme için standart kodların işlenmesi için ek kod. |
GamesSignInClient kullanır.SDK, ortak metin kodu, otomatik oturum açma ve hata işleme işlemlerini yönetir. |
Hoş Geldiniz Pop-up'ı |
Ek kod gereklidir. Geliştiriciler, yerleşimini ve zamanlamasını kontrol edebilir. |
Ek kod gerekmez Tüm yapılandırılmış PGS V2 oyunlarında tutarlı kullanıcı arayüzü. . |
Bağımlılıklar |
play-services-auth gerektirir. |
play-services-auth'a ayrı bir bağımlılık yoktur. |
| Oturumu kapat |
GoogleSignInClient.signOut kullanılır. |
Oturumu kapatma API'si desteklenmiyor. |
Birden fazla Play Oyun Hizmetleri hesabı ve oyuna özel ayarlar |
Hesap seçimi ve yönetimi kullanılamaz. |
Her oyun için Play Games Hizmetleri hesabınızı yönetebilirsiniz. Bu sayede, her oyunda hangi hesabı kullanacağınızı seçebilirsiniz. |