Catch up on everthing we announced at this year's Firebase Summit. Learn more

Google Play Oyun Hizmetlerini Kullanarak Unity'de Kimlik Doğrulama

Oyuncuların Firebase ve Unity üzerine kurulu bir Android oyununda oturum açmak için Google Play Oyunlar hizmetlerini kullanabilirsiniz. Google Play Oyunlar hizmetlerinde Firebase ile oturum açmak için önce oynatıcıda Google Play Oyunlar ile oturum açın ve bunu yaptığınızda bir OAuth 2.0 kimlik doğrulama kodu isteyin. Sonra, auth kodunu aktaracak PlayGamesAuthProvider Eğer Firebase ile kimlik doğrulaması için kullanabileceğiniz bir Firebase kimlik oluşturmak için.

Sen başlamadan önce

Unity'yi kurun

  1. Açıklanan şekilde Birlik projeye Firebase yapılandırma dosyası ve Firebase Birlik SDK'yı ekle sizin Birlik projesine Ekle Firebase . Android için talimatları izleyin.

    İthal etmek emin olun FirebaseAuth.unitypackage .

  2. Birlik Düzenleyicisi'nde, Yapı Ayarları altında> Oyuncu Ayarlar> Diğer Ayarlar oyunun Android paketi adını ayarlayın.

  3. Ardından, Yapı Ayarları altındaki> Oyuncu Ayarlar> Yayınlama Ayarları seçmek veya Android paketini imzalamak için kullanılacak bir anahtar deposunu ve anahtarı oluşturun. Play Oyunlar'da oturum açmak için APK'nızın oturum açmış olması gerekir; bu gereksinim yalnızca yayınlamak için değil, oyununuzun geliştirilmesi sırasında da geçerlidir.

Firebase projenizi kurun

  1. In Firebase konsolunda , size Birlik projesini kayıtlı olduğu Firebase projeye gidin.

  2. Dan oyununuzun SHA-1 parmak izini Set Ayarlar Eğer Unity ayarlanan tuşunu kullanarak Firebase konsolunun sayfa.

    Sen ile anahtarın SHA-1 parmak izini alabilirsiniz keytool komutu:

    keytool -exportcert -list -v \
        -alias YOUR-KEY-NAME -keystore PATH-TO-KEYSTORE

    Alternatif olarak, gradle ile imzalama sertifikasının SHA karma alabilirsiniz signingReport komutu:

    gradlew signingReport

    APK'nız, geliştirme sırasında da dahil olmak üzere bu anahtarla imzalanmalıdır.

  3. Google Play Oyunlar'ı oturum açma sağlayıcısı olarak etkinleştirin:

    1. Projenizin web sunucusu istemci kimliğini ve istemci sırrını bulun. Web sunucusu istemci kimliği, Firebase projenizi Google Play yetkilendirme sunucularına tanımlar.

      Bu değerleri bulmak için:

      1. İçinde Firebase projesini açın Google API konsolu kimlik bilgileri sayfasında.
      2. OAuth 2.0 istemci kimliği bölümünde, (Google Servisi tarafından oluşturulan otomatik) Web istemcisi sayfasını ayrıntıları açın. Bu sayfa, web sunucusu istemci kimliğinizi ve sırrınızı listeler.
    2. Sonra, içinde Firebase konsolunda , Kimlik Doğrulama bölümünü açın.

    3. Yöntem sekmede yap, Play Games oturum açma sağlayıcıya sağlar. API konsolundan aldığınız projenizin web sunucusu istemci kimliğini ve istemci sırrını belirtmeniz gerekecektir.

  1. Gelen Google Play konsoluna , uygulamayı açıp veya bir tane oluşturun.

  2. Grow adındaki bölümünde, Oyun Hizmetleri> Kurulum ve Yönetim> Yapılandırma oyna tıklayın.

  3. Evet tıklayın, benim oyun zaten kullandığı Google API'leri, listeden Firebase projesinin adını seçin ve Kullan tıklayın.

  4. Oyun Oyna Hizmetler yapılandırma sayfasında, tık Kimlik Bilgisi Ekle.

    1. Oyun sunucusu türünü seçin.
    2. OAuth istemci alanına, projenin web müşteri kimliği seçin. Bunun Play Oyunlar oturum açmayı etkinleştirdiğinizde belirttiğiniz istemci kimliğiyle aynı olduğundan emin olun.
    3. Değişikliklerinizi kaydedin.
  5. Yine Oyun Oyna Hizmetler yapılandırma sayfasında, tıklayın tekrar Kimlik Bilgisi Ekle.

    1. Android türünü seçin.
    2. OAuth istemci alanına, projenin Android müşteri kimliği seçin. (Android istemci kimliğinizi görmüyorsanız oyununuzun SHA-1 parmak izini Firebase konsolunda ayarladığınızdan emin olun.)
    3. Değişikliklerinizi kaydedin.
  6. Olaylar, Başarılar ve Liderler sayfalarda, oyununuzla kullanmak istediğiniz Play Oyunlar kaynak yaratmak (hemen herhangi kullanmak istemiyorsanız, bir yer tutucu girdisi oluşturabilirsiniz). Ardından Olaylar, Başarılar, veya Skor sayfaların herhangi birinde, kaynakları alın tıklayın ve Android kaynaklar yerde uygun pasajı kopyalayın. Google Play Oyun Hizmetleri eklentisini kurmak için snippet'e ihtiyacınız olacak.

    Kaynak snippet'i aşağıdaki örneğe benzer:

    <?xml version="1.0" encoding="utf-8"?>
    <!--
    Google Play game services IDs.
    Save this file as res/values/games-ids.xml in your project.
    -->
    <resources>
      <!-- app_id -->
      <string name="app_id" translatable="false">123456789000</string>
      <!-- package_name -->
      <string name="package_name" translatable="false">com.example.game</string>
      <!-- event Wiped Raid -->
      <string name="event_wiped_raid" translatable="false">CgkIpKjv1a4PEAIYBA</string>
    </resources>
    
  7. Test sayfasında, Play mağazasında bırakın önce oyuna giriş yapabilmek için gereken herhangi bir kullanıcının e-posta adreslerini ekleyin.

Play Oyunlar oturum açma özelliğini oyununuza entegre edin

  1. Son sürümünü indirin Birlik eklentisi Play Oyunlar ve bu bilgileri almak.

  2. Eklentinin Unity paketini Unity projenize aktarın. İçeri Birlik paketini bulabilirsiniz current-build bırakma arşiv dizinine.

  3. Play Oyunlar eklentisini kurun:

    1. Android Yapılandırma ekranını açmak için Pencere> Google Play Oyunlar> Ayarlar> Android Setup tıklayın.
    2. Android kaynaklar Kaynaklar Tanımı alanına Çal konsolundan var pasajı yapıştırın.
    3. Play etkin verdiğiniz web sunucu istemci kimliği, Yapıştır Oyun oturum açma İstemci Kimliği alanına Firebase konsolunda, içinde.
    4. Kurulum tıklayın.
  4. İle oyunda, bir Play Oyunlar istemcisi yapılandırmak RequestServerAuthCode ayar etkin:

    using GooglePlayGames;
    using GooglePlayGames.BasicApi;
    using UnityEngine.SocialPlatforms;
    using System.Threading.Tasks;
    
    PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder()
        .RequestServerAuthCode(false /* Don't force refresh */)
        .Build();
    
    PlayGamesPlatform.InitializeInstance(config);
    PlayGamesPlatform.Activate();
    
  5. Sonra, ne zaman bir oyuncu seçer Play Oyunlar'da ile oturum, çağrı Social.localUser.Authenticate() :

    Social.localUser.Authenticate((bool success) => {
      // handle success or failure
    });
    

Firebase ile kimlik doğrulaması yapın

Oyununuza Play Oyunlar oturum açma özelliğini ekledikten sonra, Firebase ile kimlik doğrulaması yapmak için Play Oyunlar hizmetlerinden kimlik doğrulama kodunu kullanabilirsiniz.

  1. Oyuncu Play Oyunlar'ı kullanarak başarıyla oturum açtıktan sonra, oturum açma devam etme işleyicisinde oyuncunun hesabı için bir yetkilendirme kodu alın:

    Social.localUser.Authenticate((bool success) => {
      if (success) {
        authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
      }
    });
    
  2. Ardından, Play Oyunlar hizmetlerinden bir Firebase kimlik bilgisi için kimlik doğrulama kodunu değiştirin ve oyuncunun kimliğini doğrulamak için Firebase kimlik bilgisini kullanın:

    Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
    Firebase.Auth.Credential credential =
        Firebase.Auth.PlayGamesAuthProvider.GetCredential(authCode);
    auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
      if (task.IsCanceled) {
        Debug.LogError("SignInWithCredentialAsync was canceled.");
        return;
      }
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCredentialAsync encountered an error: " + task.Exception);
        return;
      }
    
      Firebase.Auth.FirebaseUser newUser = task.Result;
      Debug.LogFormat("User signed in successfully: {0} ({1})",
          newUser.DisplayName, newUser.UserId);
    });
    

Sonraki adımlar

Bir kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve Play Oyunlar Kimliğine bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak depolanır ve projenizdeki her uygulamada bir kullanıcıyı tanımlamak için kullanılabilir.

Oyununuz, içinden kullanıcının Firebase UID alabilirsiniz Firebase.Auth.FirebaseUser nesnesi:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  string playerName = user.DisplayName;

  // The user's Id, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server, if you
  // have one; use User.TokenAsync() instead.
  string uid = user.UserId;
}

Senin Firebase Gerçek Zamanlı Veritabanı ve Bulut Depolama Güvenliği Kuralları, sen alabilirsiniz, kullanıcının benzersiz bir kullanıcı kimliği imzalı auth değişkeni ve hangi verilerin kullanıcı teneke erişimi kontrol etmek için kullanabilirsiniz.

Bir kullanıcının Play Oyunlar oyuncu bilgilerini almak veya Play Oyunlar hizmetlerine erişmek için Play Oyunlar eklentisi tarafından sağlanan API'leri kullanın.

Bir kullanıcı Oturumu kapatmak için çağrı SignOut() :

auth.SignOut();