Google Play Games Hizmetleri, games v1 SDK'sı, desteği sonlandırılan ve 2025'te Google Play Hizmetleri Auth SDK'sından (com.google.android.gms:play-services-auth) kaldırılacak olan Android için Google ile Giriş'i kullanır.
Yeni oyun uygulamaları, 2025'e kadar games v1'i kullanabilir. Google ile Giriş'in kaldırılması, mevcut oyun uygulamalarında bağımlılık sorunlarına neden oluyor. Mevcut oyunları/uygulamaları games v1 SDK'sından games v2 SDK'sına taşıdığınızda Google ile Giriş'in kaldırılmasıyla ortaya çıkan bağımlılık sorunları çözülür.
Bu belge, 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
Şemalarda, Android'deki bir oyun uygulaması, Google Mobil Hizmetleri (GMS) Çekirdeği, Play Oyun Hizmetleri ve üçüncü taraf (3P) oyun sunucusu arasındaki etkileşim gösterilmektedir. Uygulamanın, kimlik doğrulama ve oyun özellikleri için Google'ın hizmetlerini nasıl kullandığını ve ayrı bir üçüncü taraf sistemiyle nasıl etkileşimde bulunduğunu vurgular.
games v2 (mevcut)
games v1 (Eski)
Aşağıda, bileşenler ve SDK'lar hakkında kısa bir genel bakış sunulmuştur:
- Oyun Uygulaması.
- Bu, kullanıcının Android destekli bir cihazda çalışan oyun uygulamasını temsil eder.
- İki temel bileşenden oluşur:
- games v1 veya games v2 SDK'sı. Play Games Hizmetleri ile etkileşim kurmaktan sorumlu istemci tarafı SDK.
- Auth SDK'sı. Google Play Hizmetleri Auth SDK'sı, Games v1'deki kullanıcı kimlik doğrulama ve yetkilendirme akışlarını işlemekten sorumludur.
- Her iki SDK da AIDL (Android Arayüz Tanımlama Dili) kullanarak iletişim kurar. Bu, farklı işlemler veya hizmetler arasında bir iletişim kalıbı olduğunu gösterir.
- Google Play Hizmetleri olarak da bilinen GMS Core.
- Bu, Android'deki Google'a özel katmandır.
- Oyun uygulaması iki GMS Core modülü kullanır:
- Oyunlar Modülü, skor tabloları, başarılar ve oyun durumu yönetimi gibi oyuna özel özellikler sunar.
- Auth Module. Kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetir.
- Oyun uygulamasındaki Games ve Auth SDK'ları, AIDL arayüzlerini kullanarak ilgili modüllerle iletişim kurar. Bu, süreçler 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ı işler.
- Play Games Hizmetleri sunucusu.
- Oyun verilerini depolamaktan, kullanıcı hesaplarını yönetmekten ve çok oyunculu oyun özelliklerini kolaylaştırmaktan sorumlu Play Oyun Hizmetleri arka uç hizmetlerini temsil eder.
- Üçüncü taraf oyun ağ geçidi.
- Oyun uygulamanız üçüncü taraf (3P) uygulaması olarak nitelendiriliyorsa istemci kitaplığı, üçüncü taraf oyun sunucuları aracılığıyla Play Oyun Hizmetleri sunucularıyla iletişim kurar.
- Uygulamanın farklı bir servis sağlayıcıyla da kimlik doğrulaması yapabileceğini gösterir.
- Üçüncü taraf oyun sunucusu.
- Oyun uygulamasının etkileşimde bulunabileceği isteğe bağlı bir harici sunucuyu temsil eder. Bu sunucu, muhtemelen özel özellikler veya veri yönetimi için kullanılır.
- Uygulamayla iletişim, üçüncü taraf oyun 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ı verilmiştir:
Özellik |
games v1 SDK'sı |
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ılar, hatalar ve yeniden denemeler için ek kod. |
SDK tarafından yönetilir. |
Sunucu erişim jetonu |
GoogleSigninClient ile ek
OAuth 2.0 kapsamları isteyebilir.Oturum açma sırasında hata işleme için ek kod. |
Play Oyun Hizmetleri web API'lerine sunucu tarafı erişimi istenirken GamesSignInClient ile üç temel OAuth 2.0 kimlik kapsamı isteyebilir.
Daha fazla bilgi için Play Games Hizmetleri'ne sunucu tarafında erişim ve Sunucu kimlik doğrulama kodlarını alma başlıklı makaleleri inceleyin. |
Oturum Açma Süreci |
Kullanım alanları GoogleSigninClient.Otomatik oturum açma ve hata işleme için standart kodun işlenmesiyle ilgili ek kod. |
Kullanım alanları GamesSignInClient.SDK, standart kodu, otomatik oturum açmayı ve hata işlemeyi yönetir. |
Karşılama pop-up'ı |
Ek kod gereklidir. Geliştiriciler, yerleşimini ve zamanlamasını kontrol edebilir. |
Ek kod gerekmez. Games v2 SDK ile yapılandırılan tüm oyunlarda tutarlı kullanıcı arayüzü. |
Bağımlılıklar |
Gerektirir play-services-auth. |
Oyunlar modülü, yetkilendirme ve kimlik doğrulama işlemlerini gerçekleştirir. Başka bağımlılık eklemeniz gerekmez. |
| Oturumu kapatma |
GoogleSignInClient.signOut kullanılır. |
Oturumu kapatma API'si desteklenmez. |
Birden fazla Play Games Hizmetleri hesabı ve oyun başına ayarlar |
Hesap yönetimi oyununuzda mümkündür. |
Kullanıcılar, Play Games Hizmetleri profilini mobil cihaz ayarlarından değiştirebilir. Daha fazla bilgi için Mobil cihazlarda Play Games profilleri arasında geçiş yapma başlıklı makaleyi inceleyin. |