Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. 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. Ardından, Firebase ile kimlik doğrulaması yapmak için kullanabileceğiniz bir Firebase kimlik bilgisi oluşturmak için yetkilendirme kodunu PlayGamesAuthProvider iletin.

Sen başlamadan önce

Unity'yi kurun

  1. Firebase yapılandırma dosyasını ve Firebase Unity SDK'sını Unity projenize Firebase'i Unity projenize ekleme bölümünde açıklandığı gibi ekleyin . Android için talimatları izleyin.

    FirebaseAuth.unitypackage içe FirebaseAuth.unitypackage emin olun.

  2. Unity Editor'da, Yapı Ayarları > Oyuncu Ayarları > Diğer Ayarlar altında oyununuzun Android paketi adını ayarlayın.

  3. Ardından, Yapı Ayarları > Oynatıcı Ayarları > Yayınlama Ayarları altında , Android paketinizi imzalamak için kullanılacak bir anahtar deposu ve anahtar seçin veya 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. Firebase konsolunda Unity projenizi kaydettiğiniz Firebase projesine gidin.

  2. Unity'de ayarladığınız anahtarı kullanarak Firebase konsolunun Ayarlar sayfasından oyununuzun SHA-1 parmak izini ayarlayın.

    keytool komutuyla anahtarınızın SHA-1 parmak izini alabilirsiniz:

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

    Alternatif olarak, imzalama sertifikanızın SHA karmasını gradle signingReport komutuyla alabilirsiniz:

    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 kimlik doğrulama sunucularına tanımlar.

      Bu değerleri bulmak için:

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

    3. Oturum açma yöntemi sekmesinde Play Oyunlar oturum açma sağlayıcısını etkinleştirin. API konsolundan aldığınız projenizin web sunucusu istemci kimliğini ve istemci sırrını belirtmeniz gerekecektir.

  1. Google Play konsolunda uygulamanızı açın veya bir tane oluşturun.

  2. Büyüme bölümünde Play Oyunlar Hizmetleri > Kurulum ve Yönetim > Yapılandırma'yı tıklayın .

  3. Evet, oyunum zaten Google API'lerini kullanıyor 'u tıklayın, listeden Firebase projenizin adını seçin ve Kullan 'ı tıklayın.

  4. Play Oyun Hizmetleri yapılandırma sayfasında, Kimlik Bilgisi Ekle 'yi tıklayın.

    1. Oyun sunucusu türünü seçin.
    2. OAuth istemcisi alanında projenizin web istemci kimliğini 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 Play Oyun Hizmetleri yapılandırma sayfasında, tekrar Kimlik Bilgisi Ekle'yi tıklayın.

    1. Android türünü seçin.
    2. OAuth istemcisi alanında projenizin Android istemci kimliğini 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. Etkinlikler , Başarılar ve Skor Tabloları sayfalarında, oyununuzla kullanmak istediğiniz Play Oyunlar kaynaklarını oluşturun (hemen kullanmak istemiyorsanız bir yer tutucu girişi oluşturabilirsiniz). Ardından, Etkinlikler , Başarılar veya Lider Tabloları sayfalarından herhangi birinde Kaynak al'ı tıklayın ve Android kaynakları snippet'ini uygun bir yere 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çiler sayfasında, oyununuzu Play Store'da yayınlamadan önce oturum açabilmesi gereken tüm kullanıcıların e-posta adreslerini ekleyin.

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

  1. Unity için Play Oyunlar eklentisinin en son sürümünü indirin ve çıkarın.

  2. Eklentinin Unity paketini Unity projenize aktarın. Unity paketini, sürüm arşivinin current-build dizininde bulabilirsiniz.

  3. Play Oyunlar eklentisini kurun:

    1. Android Yapılandırma ekranını açmak için Pencere > Google Play Oyunlar > Kurulum > Android Kurulumu'nu tıklayın .
    2. Play konsolundan aldığınız Android kaynakları snippet'ini Kaynak Tanımı alanına 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'u tıklayın.
  4. Oyununuzda, RequestServerAuthCode ayarının etkin olduğu bir Play Oyunlar istemcisi yapılandırın:

    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. Ardından, bir oyuncu Play Oyunlar ile oturum açmayı seçtiğinde Social.localUser.Authenticate() arayın:

    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.

Oyununuzda, kullanıcının Firebase Firebase.Auth.FirebaseUser nesnesinden alabilirsiniz:

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;
}

Firebase Gerçek Zamanlı Veritabanınız ve Bulut Depolama Güvenlik Kurallarınızda, oturum auth kullanıcının benzersiz kullanıcı kimliğini auth değişkeninden alabilir ve bunu bir kullanıcının hangi verilere erişebileceğini 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ının oturumunu kapatmak için SignOut() arayın:

auth.SignOut();