Sorunsuz geri yükleme

Sorunsuz Geri Yükleme, geri dönen oyuncuları yeni bir cihaza oyun yüklediklerinde veya oyunu yeniden yüklediklerinde oyun ilerlemelerine anında yeniden bağlamak için tasarlanmış bir Google Play Games Hizmetleri özelliğidir. Bu özellik, oturum açma ekranının zorluğunu etkili bir şekilde ortadan kaldırır.

Sorunsuz geri yükleme, Level Up programı için önerilen bir yönergedir.

Oyununuzda kullanıcı platformu kimlik doğrulama deneyimini kolaylaştırmak için Google Play Oyun Hizmetleri'ni kullanın. Kimlik doğrulama işlemini tetiklemek için Play Games Hizmetleri SDK'sını başlatın. Bu işlem, ayrı bir platform kimlik doğrulama akışına olan ihtiyacı ortadan kaldırır.

Sürekliliği ve cihazlar arası oynatmayı etkinleştirmek için kullanıcı hesaplarını bağlama

Oyuncular, mobil cihazlar, tabletler ve PC'ler dahil olmak üzere çeşitli cihazlarda ve platformlarda en sevdikleri oyunlarla etkileşim kuruyor. Bu oyuncuların temel beklentilerinden biri, seçtikleri cihazdan bağımsız olarak oyunlarına kaldıkları yerden sorunsuz bir şekilde devam edebilmektir.

Kullanıcıların hizmeti bırakmasına neden olan önemli bir engel, her yeni cihazda ayrı ayrı oturum açma zorunluluğudur. Kullanıcıların, gereksiz kesintiler olmadan oyun deneyimine anında dahil olması gerekir.

Sorunsuz devamlılık ve cihazlar arası oyun deneyimi sağlamak için iki temel özelliği uygulamanız gerekir:

Play Games Hizmetleri kimlik doğrulama süreci, oyuncu tanımlayıcıları için esnek seçenekler sunar. Bu seçenekler, Play Games Hizmetleri'ni kendi mevcut kimlik çözümünüzle entegre etmenize olanak tanır.

Yeni Play Oyun Hizmetleri entegrasyonu

Mevcut Play Games Hizmetleri entegrasyonu olmayan oyunlarda Recall API, hesap ilişkilendirmelerini yöneterek ve kullanıcının oyun hesabı ile Play Games Hizmetleri hesabı arasındaki bağlantıyı depolayarak arka uç kurulumunu basitleştirir.

Recall API'yi kullanarak hesap bağlama

Recall API, platformlar arası oyunlarda kullanıcı hesaplarını bağlamak için önerilen çözümdür. Bu API, özellikle mevcut Play Games Hizmetleri entegrasyonu olmayan veya Play Games Hizmetleri'nin ötesinde ek platform kimlik doğrulama çözümleri kullanan oyunlar için kullanışlıdır.

Recall API, hesap ilişkilendirmelerini yöneterek oyununuzun arka uç kurulumunu basitleştirir.

Basitleştirilmiş arka uç: API, hesap bağlama için oyununuzun arka uç kurulumunu kolaylaştırır.
Play tarafından yönetilen ilişkilendirmeler: Play, kullanıcıların oyun hesapları (üçüncü taraf hesapları dahil) ile Play Games Hizmetleri hesapları arasındaki ilişkilendirmeyi saklar.
İlerleme durumunu geri yükleme: Geliştiriciler, Play'e Recall jetonları oluşturup gönderir. Bu jetonlar daha sonra alınarak kullanıcının oyundaki ilerleme durumu geri yüklenebilir.

Geliştiriciler, Recall API'yi uygularken Recall jetonlarının opak dizeler olduğunu doğrulamalıdır. Bu jetonlar, oyuncularla ilgili herhangi bir hassas veya kimliği tanımlayabilecek bilgiler (ad, e-posta adresi veya demografi gibi) içermemelidir.

Oyunlar, kullanıcı verilerini korumak ve güvenliği sağlamak için Recall jetonları oluştururken güçlü şifreleme algoritmaları kullanmalıdır.

Recall'un işleyiş şekli hakkında daha fazla bilgi edinmek için Recall API başlıklı makaleyi inceleyin.

Recall API özelliğini uygulamak için Play Games Hizmetleri Recall API'yi oyununuza entegre etme başlıklı makaleyi inceleyin.

Mevcut Play Games Hizmetleri entegrasyonu

Bu bölümde, oyuncu hesaplarını bağlayarak oyununuzu Play Games Hizmetleri ile nasıl entegre edeceğiniz açıklanmaktadır. Kimliği doğrulanmış oyuncuları tanımlamak ve tek bir Play Games Hizmetleri kullanıcısı için birden fazla oyun hesabını yönetmek üzere oyuncu kimliklerini nasıl kullanacağınızı öğrenin.

`Player_id` ile bağlama

Oyuncu kimliği, Play Games Hizmetleri oyuncu hesabının tanımlayıcısıdır. Oyununuz, Play Games Hizmetleri'ni kullanarak oyununuzda kimliği doğrulanan tüm oyuncular için oyuncu kimliği alabilir.

Arka ucu Play Games Hizmetleri ile ayarlanmış oyunlar Player_Id veya çocuk kullanıcılar için destek gerektiren oyunlar Player_Id kullanmalı ve oyun ile 3. taraf hesaplarını Player_Id ile bağlamalıdır.

Oyuncu kimliklerinin nasıl davrandığını anlama:

Oyun içinde tutarlı: Bir oyuncu kimliği, aynı oyunu oynayan kullanıcının birden fazla cihazında tutarlı kalır.
Oyunlar arasında tutarsızlık: Kullanıcı farklı oyunlar oynadığında oyuncu kimlikleri her zaman tutarlı olmaz.

Daha fazla bilgi için yeni nesil oyuncu kimlikleri başlıklı makaleyi inceleyin.

Bağlama ile kullanıcı başına birden fazla hesabı yönetme

Birden fazla kullanıcı hesabını tek bir Play Games Hizmetleri hesabına bağlamak için tablonuzda bire çok eşleme oluşturun.

Google ile oturum açma özelliğini kullanarak platformlar arası Google kimliği

Google ile Oturum Açma (SiwG), Google'ın birincil kimlik çözümüdür. Bu çözüm, oyun geliştiricilerin oyuncularının profil bilgilerini (ad, e-posta adresi ve profil resmi) güvenli bir şekilde almasına olanak tanır.

Google ile oturum açmanın temel avantajlarından biri, web, Android ve iOS dahil olmak üzere platformlar genelinde geniş bir kullanım alanına sahip olmasıdır. Oyuncuların bildiği ve güvendiği hızlı, güvenli ve tanıdık bir oturum açma deneyimi sunar.

Google kimliği jetonunun `sub` alanı ile bağlama

Platformlar arası sorunsuz bir deneyim oluşturmak için oyununuzun hesap sistemini benzersiz bir Google Hesabı tanımlayıcısına bağlayan bir kimlik doğrulama stratejisi uygulayabilirsiniz. Bu yaklaşımda, Android'de Play Games Hizmetleri'nin basitleştirilmiş kimlik doğrulama özelliği kullanılırken iOS ve web gibi diğer platformlarda standart Google ile Oturum Açma SDK'sı kullanılır.

Google kimlik jetonundaki sub alanı, Google kullanıcısının hesabının benzersiz ve kalıcı tanımlayıcısıdır. Bu sub alanı, aynı kullanıcı için tüm platformlarda aynıdır. Oyuncunun ilerleme durumunu cihazlar arasında bağlamak ve geri yüklemek için arka uçta benzersiz anahtar olarak bu sub değerini kullanın. Bu anahtar, oyuncunun tüm oturumlarını arka uçtaki tek bir oyun hesabına bağlar.

İşlemin genel akışı şu şekildedir:

Android'de: Oyununuz, Android cihazlarda platform kimlik doğrulamasını otomatik olarak tetiklemek için Play Games Hizmetleri SDK'sını başlatır. Android'de Google ile oturum açtığınızda şu üç oturum açma kapsamını isteyin: email, profile ve openid. Play Games Hizmetleri v2 entegrasyonunu kullanmayın. Bunlar, standart SiwG SDK'sının istediği kapsamlarla aynıdır. Bu yöntem, oyuncunun sub alanını içeren bir kimlik jetonu almanıza olanak tanır.
Web ve iOS'te: Oyununuzda standart web için Google ile oturum açma, iOS ve macOS için Google ile oturum açma SDK'ları kullanılıyor. Kullanıcı oturum açtığında SiwG SDK, kullanıcının sub alanını da içeren bir kimlik jetonu sağlar.
Hesap Bağlama: Kullanıcı her iki platformda da aynı Google Hesabı ile oturum açtığı için aldığınız sub alanı aynı olur. Ardından, kimlik çözümünüzde bu sub değerini dahili kullanıcı kimliğinize güvenle bağlayarak birleşik bir kullanıcı deneyimi oluşturabilirsiniz.

Android'de entegrasyon

Android'de, Android cihazlarda platform kimlik doğrulamasını otomatik olarak tetiklemek için Play Games Hizmetleri SDK'sını başlatın. Ardından, Android'de Google ile oturum açtığınızda email, profile ve openid olmak üzere üç oturum açma kapsamı isteyin. Bu sayede, arka uçunuzun benzersiz sub alanı da dahil olmak üzere kullanıcının bilgilerini içeren bir kimlik jetonuyla değiştirebileceği bir sunucu tarafı yetkilendirme kodu alabilirsiniz.

Genel olarak uygulama şunları içerir:

Birleştirilmiş bir projede istemci kimliklerini ayarlama: Entegrasyon yapmadan önce, OAuth 2.0 istemci kimliklerinizi almak için Google Play Console'da Play Games Hizmetleri'ni ayarlamanız gerekir.

Önemli: Platformlar arası bağlantı için bu Google Cloud projesi tüm platformlarda kullanılmalıdır. Diğer platformlar (ör. web ve iOS) için daha sonra oluşturacağınız tüm istemci kimlikleri bu projeye eklenmelidir.
Play Oyun Hizmetleri'ni yapılandırın: Öncelikle oyununuzu Google Play Console'a ekleyin ve Play Oyun Hizmetleri platform kimlik doğrulamasını oyununuza entegre edin.
Google ile oturum aç düğmesi ekleme: Oyununuzun oturum açma sayfasına veya kullanıcı ayarları ekranına Google ile oturum aç düğmesi ekleyin. Bu düğme, oturum açma veya kaydolma akışını tetikler. Bu düğmeyi oluştururken Google ile oturum açma markalama kurallarına uymanız önerilir. Düğmede en azından "Google" veya "Google ile oturum açın" ifadesi açıkça gösterilmelidir. Kurallar bağlantısında, oyununuzda kullanabileceğiniz ve uyumlu kullanıcı deneyimi öğeleri de indirilebilir.
Oturum açma kapsamlarıyla sunucu yetkilendirme kodu isteyin: Oyuncu düğmeyi tıkladığında oyununuz tek seferlik bir sunucu yetkilendirme kodu ister. En önemli adım, bu isteği aşağıdaki oturum açma kapsamlarını içerecek şekilde yapılandırmaktır: EMAIL, PROFILE ve OPEN_ID.

Bunu nasıl yapılandıracağınız geliştirme ortamınıza bağlıdır:
- Java/Kotlin için: requestServerSideAccess kullanarak sunucu yetkilendirme kodunu alma rehberine bakın.
- Unity için: Unity'de yetkilendirme kodlarını alma kılavuzuna bakın.
Yetkilendirme kodunu değiştirin ve arka uçta kimlik jetonunu doğrulayın: Önceki adımdaki yetkilendirme kodunu arka uç sunucunuza gönderin. Sunucuda, kodu kimlik jetonu, erişim jetonu ve yenileme jetonuyla değiştirmek için standart OAuth 2.0 kod değişimi akışı kılavuzunu uygulayın. Rehberde açıklandığı gibi, kimlik jetonunu sunucunuzda doğrulamanız gerekir.
sub alanını bağlayın: Kimlik jetonu başarıyla doğrulandıktan sonra, sub alanını yükünden çıkarın. Bu sub değerini, kimlik çözümünüzde Google kimliği için benzersiz anahtar olarak kullanın.
- Veritabanınızda bu sub değeri zaten varsa kullanıcı daha önce bağlantı oluşturmuştur. İlgili oyun hesabında oturum açmalarını sağlayın.
- Bu sub değeri yoksa, oyununuzun hesap sisteminde bu sub ile ilişkili yeni bir kullanıcı hesabı oluşturabilir veya kimlik jetonunda sağlanan kullanıcı bilgilerini (ör. e-posta adresi) eşleştirerek hesap sisteminizdeki mevcut bir kullanıcı hesabına bağlantı oluşturabilirsiniz.

iOS, web ve diğer platformlarda entegrasyon

Android, iOS, Web veya PC dışındaki platformlarda standart Google ile oturum açma SDK'larını kullanırsınız. Amaç, Android akışıyla aynıdır: Google kimliği jetonunu güvenli bir şekilde almak, arka uçunuza göndermek ve hesabı bağlamak için sub alanını kullanmak.