Taşımaya genel bakış

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.

Google Play Games Hizmetleri v1'den v2'ye geçiş, geliştirmeyi basitleştiren ve platformlar arası oyunları destekleyen önemli bir güncellemedir. Google Play Games Hizmetleri v2, platform ve oyun içi kimliği birbirinden ayırır. Bu sürüm, oyuncuları başlatma sırasında otomatik olarak doğrulayan platform düzeyinde bir kimlik sistemi olarak işlev görür. Platform kimliği artık birincil oyun içi hesap sisteminden ayrıdır. Bu sistemi, Google ile oturum açma veya tescilli arka uçlar gibi araçları kullanarak bağımsız olarak yönetmeniz gerekir. Play Games Hizmetleri v2 SDK entegrasyonu, mevcut ilk katılım veya giriş akışlarını değiştirmeden başarılar ve skor tabloları gibi platform özelliklerinde oyuncu kimliğini kullanır.

Bu belge, oyun uygulaması ile çeşitli SDK'lar arasındaki etkileşimleri anlamanıza yardımcı olur. Resmi desteği sonlandırma zaman çizelgesi nedeniyle, oyuncu devamlılığını sağlamak için bu taşıma kılavuzunun mimari ilkelerini, yollarını ve oyuncu iletişim stratejilerini uygulamanız gerekir.

SDK etkileşimleri

Şemalarda, Android'deki bir oyun uygulaması, Google Mobil Hizmetleri (GMS) Core, Play Games 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.

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'sı.
    • 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ğrulaması ve yetkilendirme işlemlerini gerçekleştirir.
  • Oyun uygulamasındaki Games ve Auth SDK'ları, AIDL arayüzlerini kullanarak ilgili modüllerle iletişim kurar. Bu durum, 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ğrulayabileceğ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.

Neden oyununuzu Play Games Hizmetleri v2'ye taşımanız gerekir?

Play Games Hizmetleri v1'den v2'ye geçiş, geliştirme sürecini basitleştiren ve platformlar arası oyunları destekleyen önemli bir mimari modernizasyondur.

Oyun içi birincil kimlik sistemi olarak kullanılan v1'in aksine, Play Games Hizmetleri v2, platform ve oyun içi kimliği birbirinden ayırır. Başlatıldığında oyuncuları otomatik olarak kimlik doğrulayan ve başarılar ile skor tabloları gibi özellikleri yöneten bir platform düzeyinde kimlik sistemi olarak işlev görür.

Artık Google ile oturum açma veya tescilli arka uçlar gibi araçları kullanarak oyununuzun birincil oyun içi hesap sistemini bağımsız olarak yönetmeniz gerekiyor. Play Games Hizmetleri v2 SDK'sı, oyunların mevcut oryantasyon veya giriş akışlarını değiştirmeden platform özelliklerine erişmek için Play Games Hizmetleri oyuncu kimliğini kullanmasına olanak tanır. Bu belge, mimari ilkeleri, yolları ve oyuncu iletişimi stratejilerini kapsayarak geçiş sürecinde size rehberlik eder. Resmi desteğin sonlandırılma zaman çizelgesi göz önüne alındığında, oyuncu devamlılığı için bu geçişi yapmanız kritik önem taşır.

Platform kimlik doğrulaması ile oyun içi kimlik doğrulamasını karşılaştırma

Play Games Hizmetleri v2'de "oturum açma" kavramı iki ayrı katmana ayrılmıştır:

• Platform kimliği. SDK, platform kimlik doğrulamasını işler.
• Oyun içi kimlik.

Platform kimlik doğrulaması

Play Games Hizmetleri, yalnızca bir platform etkileşimi katmanı olarak işlev görür. Oyuncunun belirli bir oyun hesabında veya envanterinde kimliğini doğrulamak yerine Google Play Games ekosistemiyle (başarılar, skor tabloları ve etkinlikler) ilişkisini yönetir.

• Sessiz ve Otomatik: Oyun başlatıldığında kimlik doğrulama otomatik olarak arka planda gerçekleşir. Play Games Hizmetleri için manuel "Oturum aç" düğmesi gerekmez.
• Oyuncu kimliği: Platform kimlik doğrulaması başarılı olduğunda Play Games Hizmetleri, sabit bir oyuncu kimliği sağlar. Bu kimlik, aynı oyunda cihazlar arasında tutarlıdır ancak öncelikli olarak platform istatistiklerini (ör. başarı ilerlemesi) izlemek için kullanılmalıdır.
• Ayrılmış: Play Games Hizmetleri v2, oyununuzun oyuncuların oyun içi hesaplarını oyun ilerlemeleri veya envanterleriyle yönetmek için kullandığı birincil kimlik sistemi olarak kullanılmamalıdır. Google Play Games Hizmetleri v2, kesinlikle ikincil ve kalıcı bir platform tanımlayıcısı olarak işlev görür.

Oyun içi kimlik doğrulama

Geliştiriciler, "oyun içi hesap"ın (IGA) yönetiminden sorumludur. Bu, oyuncunun oyununuzdaki ilerleme durumunu, envanterini ve para birimini bağlayan kimlik sistemidir.

• Birincil Kimlik: Birincil Giriş Yöntemi olarak kendi arka uç sisteminizi, Google ile oturum açmak'ı (SiWG) veya diğer sağlayıcıları kullanabilirsiniz.
• Bağımsızlık: Oyuncular, belirli bir oyun içi hesaba giriş yapmışken Play Games Hizmetleri'nde (Platform Kimliği) oturum açarak başarı kazanabilir. Örneğin, konuk hesabı veya belirli bir SiWG hesabı.
• Birden Fazla Oyun İçi Hesabın Yönetimi: Play Games Hizmetleri yalnızca platform kimlik doğrulamasından sorumludur. Oyuncuların oyun içi hesaplarındaki (IGA) birincil kimlik doğrulama, oyununuz tarafından yönetilir. Bu nedenle, oyuncuların oyun içi hesapları arasında geçiş yapma şekliyle ilgili olarak oyununuzun mevcut akışlarında herhangi bir değişiklik olmaz. Oyuncular bu işlemi yaparken Play Games Hizmetleri'ni kullanarak Play Games platformunda kimlik doğrulaması yapmaya devam eder ve başarılar ile diğer Play Games Hizmetleri özellikleriyle ilgili verilerini kalıcı oyuncu kimliğiyle göndermeye devam edersiniz.

Taşıma şartı: Oyun içi hesapları Play Games Hizmetleri oyuncu kimliği yerine Google Open ID ile bağlama

Play Games Hizmetleri v1'de geliştiriciler, Play Games Hizmetleri'ni birincil kimlik sağlayıcı olarak kullanıyordu. "Google Play" düğmesi, oyuncunun oyun içi hesabını (IGA) doğrudan Player ID hesabına bağlar.

Play Games Hizmetleri v2, otomatik ve sessiz platform kimlik doğrulaması sağlayarak bu durumu değiştiriyor. Sonuç olarak ortaya çıkan Player ID, artık ana hesap girişinden ayrı olarak skor tabloları ve başarılar gibi platform özelliklerinde kullanılıyor.

Oyunlar artık "Google ile oturum açma" (SiWG) veya diğer sosyal hesaplar gibi yöntemler sunan özel bir giriş ekranı aracılığıyla birincil kimliği bağımsız olarak yönetmelidir.Play Games Hizmetleri v2, birincil kimlik sistemi olarak kullanılmamalıdır.

Bu mimari değişiklik, geliştiricilerin hesap verilerini yapılandırma biçiminde de benzer bir değişikliği gerektirir. Oyun İçi Hesap (IGA), öncelikle Player ID'ya bağlı olmaktan çıkarılmalıdır.

Bunun yerine, IGA artık Play Oyun Hizmetleri'nden bağımsız olan sabit bir birincil tanımlayıcıya bağlanmalıdır. Önerilen tanımlayıcı, Google ile oturum açma (SiWG) akışı tarafından sağlanan Open ID değeridir. Bu Open ID, sisteminizdeki oyuncunun ana hesabı için benzersiz ve kalıcı anahtar görevi görür.

Ancak IGA, ikincil bir bağlayıcı olarak Player ID'ye bağlanmaya devam edebilir. Bu ikincil bağlantı iki önemli işlevi yerine getirir:

1. Bu izin, oyunun söz konusu oyuncuyla ilişkili Play Games özelliklerinin (başarılar vb.) ilerleme durumunu takip etmeye ve güncellemeye devam etmesini sağlar.
2. Bu işlev, "Sorunsuz Geri Yükleme" işlevini etkinleştirerek oyunun, oyuncuyu yalnızca yeni bir cihazda veya yeniden yükleme işleminden sonra en son kullandığı IGA'ya otomatik olarak giriş yapmasına olanak tanır.

Bu ayrılmış kimlik modelini anlamak, oyununuz için doğru teknik taşıma yolunu bulmanın anahtarıdır.

Ö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 sadeleştirilmiş; play-services-auth gerekmez.
Yetkilendirme	Başarı, hata ve yeniden deneme 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. "Oturum açma" işlemi iki ayrı katmana ayrılır: Platform kimlik doğrulaması: Play Games Hizmetleri v2 SDK'sı tarafından işlenir. Oyun içi kimlik doğrulama: Oyun tarafından işlenir.
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.	Play Games Hizmetleri v2 kalıcı bir platform kimliği olduğundan oturumu kapatma API'si gerekli değildir.
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.