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 Oturum Açma'yı kullanır.
Yeni oyun uygulamaları, 2025'e kadar games v1'i kullanabilir. Google ile Oturum Açma'nın kaldırılması, mevcut oyun uygulamalarında bağımlılık sorunlarına yol açıyor. Mevcut oyun
uygulamalarını games v1
SDK'sından games v2 SDK'sına taşıyarak
Google ile Oturum Açma'nın kaldırılmasıyla ortaya çıkan bağımlılık sorunlarını çözebilirsiniz.
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) Core, Play Oyun Hizmetleri ve üçüncü taraf (3P) oyun sunucusu arasındaki etkileşim gösterilmektedir. Bu dokümanda, uygulamanın kimlik doğrulama ve oyun özellikleri için Google'ın hizmetlerini nasıl kullandığı ve ayrı bir üçüncü taraf sistemiyle nasıl etkileşimde bulunduğu açıklanmaktadır.
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şimden 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, Google'ın Android'deki tescilli katmanıdır.
- Oyun uygulaması iki GMS Core modülü kullanır:
- Games Module, 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 Games 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 Games 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 Games 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 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ı verilmiştir:
Özellik |
games v1 SDK'sı |
games v2 SDK'sı |
|---|---|---|
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.Kimlik doğrulama sırasında hata işleme için ek kod. |
Play Games Hizmetleri web API'lerine sunucu tarafı erişimi istenirken GamesSignInClient ile üç temel OAuth 2.0 kimlik kapsamı isteyebilir.
Daha fazla bilgi için Play Oyun 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 kimlik doğrulama ve hata işleme için ortak metin kodunun işlenmesiyle ilgili ek kod. |
Kullanım alanları GamesSignInClient.SDK, ortak metin kodunu, otomatik kimlik doğrulamayı 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 |
play-services-auth gerektirir. |
Games modülü, yetkilendirme ve kimlik doğrulama işlemlerini gerçekleştirir. Başka bağımlılık eklemeniz gerekmez. |
| Oturumu kapatma |
Kullanım alanları GoogleSignInClient.signOut. |
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, mobil cihaz ayarlarından Play Games Hizmetleri profilini değiştirebilir. Daha fazla bilgi için Play Games profilleri arasında mobil cihazda geçiş yapma başlıklı makaleyi inceleyin. |