Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kimlik ve hesap bağlama

Oyununuzda kullanıcı platformu kimlik doğrulama deneyimini basitleştirmek için Google Play Oyun Hizmetleri kimlik doğrulamasını 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:

Hesap bağlama
Buluta kaydetme

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.

Recall API ile birden fazla hesabı yönetme

Aynı kullanıcının birden fazla hesabını yönetirken her hesabı ayrı bir karakter olarak değerlendirebilirsiniz. Bu yaklaşım, kullanıcının bağlamına göre özelleştirilmiş deneyimler sunar.

Bu yaklaşımı uygulamak için aşağıdaki adımları izleyin:

Her karakter için benzersiz bir jeton oluşturun. Oyun istemcisi kurulumu başlıklı makaleyi inceleyin.
Recall API'yi kullanarak bu jetonları Play Games Hizmetleri hesabına bağlayın. Jetonları saklama bölümüne bakın.
Play Games Hizmetleri hesabının birden fazla karakterle bağlantılı olduğu senaryolar için bir çözüm politikası belirleyin. Geliştirici hesaplarının sahip olduğu tüm oyunlardaki en son geri çağırma jetonu başlıklı makaleyi inceleyin.

Çeşitli politika seçenekleri (ör. son hesabın otomatik olarak geri yüklenmesi) olsa da kullanıcıya bir istem göstermenizi önemle tavsiye ederiz. Bu istemde, kullanıcılardan hangi hesabı geri yüklemek istediklerini seçmeleri istenir. Böylece net ve kullanıcı dostu bir deneyim sunulur.

Mevcut Play Oyun 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 üçüncü 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ılabilirliğe 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

Sorunsuz bir platformlar arası 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.

Bu stratejinin anahtarı, Google kimlik jetonundaki sub alanıdır. sub (veya "konu") alanı, Google kullanıcısının hesabının benzersiz ve kalıcı tanımlayıcısıdır. Bu kimliği, bir oyuncunun tüm oturumlarını arka uçtaki tek bir oyun hesabına bağlamak için "köprü" olarak kullanırsınız.

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

Android'de: Oyununuz, Android cihazlarda kimlik doğrulamanın otomatik olarak tetiklenmesi için Play Games Hizmetleri SDK'sını başlatır. Play Games Hizmetleri v2 entegrasyonunuzu, üç oturum açma kapsamını isteyecek şekilde yapılandırıyorsunuz: email, profile ve openid. Bunlar, standart bir Google ile oturum açma SDK'sının istediği kapsamlarla aynıdır. Bu, 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 birincil entegrasyon noktası olarak Google Play Games Hizmetleri SDK'sını kullanırsınız. Buradaki önemli nokta, Google Play Oyun Hizmetleri oturum açma istemcinizi ek oturum açma kapsamlarını isteyecek şekilde yapılandırmaktır. 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 sunucu tarafı bir 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 Games Hizmetleri'ni yapılandırın: Başlamadan önce Google Play Console'da oyununuzu eklemeniz ve Play Games Hizmetleri platform kimlik doğrulamasını oyununuza entegre etmeniz gerekir.
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 yönergelerine 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 kimlik doğrulama kodu isteyin: Oyuncu düğmeyi tıkladığında oyununuz tek seferlik bir sunucu kimlik doğrulama 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 kimlik doğrulama 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.