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

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

Oyuncuların Firebase ü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

Android projenizi kurun

  1. Eğer henüz yapmadıysanız, Android projeye Firebase ekleyin .

  2. Kullanılması Firebase Android Bom , senin modülü (uygulama düzeyinde) Gradle dosyası (genellikle Firebase Kimlik Android kütüphanesi için bağımlılık beyan app/build.gradle ).

    Ayrıca, Firebase Authentication'ı ayarlamanın bir parçası olarak, uygulamanıza Google Play hizmetleri SDK'sını eklemeniz gerekir.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare the dependency for the Firebase Authentication library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:19.2.0'
    }

    Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

    (Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

    Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

    Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

    dependencies {
        // Declare the dependency for the Firebase Authentication library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth:21.0.1'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:19.2.0'
    }

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare the dependency for the Firebase Authentication library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth-ktx'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:19.2.0'
    }

    Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

    (Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

    Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

    Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

    dependencies {
        // Declare the dependency for the Firebase Authentication library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth-ktx:21.0.1'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:19.2.0'
    }

Firebase projenizi kurun

  1. Dan oyununuzun SHA-1 parmak izini Set Ayarlar Firebase konsolunun sayfa.

    Sen gradle ile imzalama sertifikasının SHA karma alabilirsiniz signingReport komutu:

    ./gradlew signingReport

  2. 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. İç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. 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

Öncelikle Play Oyunlar oturum açma özelliğini uygulamanıza entegre edin. Bkz Android Oyunlar'da oturum açma talimatlar için.

Eğer inşa ederken entegrasyon olarak, GoogleSignInOptions nesneyi kullanmak DEFAULT_GAMES_SIGN_IN yapılandırma ve çağrı requestServerAuthCode :

Java

GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestServerAuthCode(getString(R.string.default_web_client_id))
        .build();

Kotlin+KTX

val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestServerAuthCode(getString(R.string.default_web_client_id))
        .build()

Sen için web sunucusu istemci kimliği geçmelidir requestServerAuthCode yöntemiyle. Bu, Firebase konsolunda Play Oyunlar oturum açmayı etkinleştirdiğinizde sağladığınız kimliktir.

Firebase ile kimlik doğrulaması yapın

Uygulamanıza Play Oyunlar oturum açma özelliğini ekledikten sonra, bir oyuncu Play Oyunlar'da başarılı bir şekilde oturum açtığında aldığınız Google hesabı kimlik bilgilerini kullanmak için Firebase'i ayarlamanız gerekir.

  1. Öncelikle, içinde etkinliğin oturum açma onCreate yöntemin, ortak örneğini almak FirebaseAuth nesnesi:

Java

private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();

Kotlin+KTX

private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.auth
  1. Aktivitenizi başlatırken, oyuncunun zaten Firebase ile oturum açıp açmadığını kontrol edin:

Java

@Override
public void onStart() {
    super.onStart();
    // Check if user is signed in (non-null) and update UI accordingly.
    FirebaseUser currentUser = mAuth.getCurrentUser();
    updateUI(currentUser);
}

Kotlin+KTX

override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
  1. Ya sessizce ya etkileşimli Play ile Oyunları'nda bir oyuncu açtıktan sonra gelen auth kodu almak GoogleSignInAccount Firebase Firebase kimlik kullanarak, nesnenin bir Firebase kimlik için değiştirecek ve authenticate:

Java

// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private void firebaseAuthWithPlayGames(GoogleSignInAccount acct) {
    Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.getId());

    final FirebaseAuth auth = FirebaseAuth.getInstance();
    AuthCredential credential = PlayGamesAuthProvider.getCredential(acct.getServerAuthCode());
    auth.signInWithCredential(credential)
            .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
                @Override
                public void onComplete(@NonNull Task<AuthResult> task) {
                    if (task.isSuccessful()) {
                        // Sign in success, update UI with the signed-in user's information
                        Log.d(TAG, "signInWithCredential:success");
                        FirebaseUser user = auth.getCurrentUser();
                        updateUI(user);
                    } else {
                        // If sign in fails, display a message to the user.
                        Log.w(TAG, "signInWithCredential:failure", task.getException());
                        Toast.makeText(MainActivity.this, "Authentication failed.",
                                Toast.LENGTH_SHORT).show();
                        updateUI(null);
                    }

                    // ...
                }
            });
}

Kotlin+KTX

// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private fun firebaseAuthWithPlayGames(acct: GoogleSignInAccount) {
    Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.id!!)

    val auth = Firebase.auth
    val credential = PlayGamesAuthProvider.getCredential(acct.serverAuthCode!!)
    auth.signInWithCredential(credential)
            .addOnCompleteListener(this) { task ->
                if (task.isSuccessful) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInWithCredential:success")
                    val user = auth.currentUser
                    updateUI(user)
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInWithCredential:failure", task.exception)
                    Toast.makeText(baseContext, "Authentication failed.",
                            Toast.LENGTH_SHORT).show()
                    updateUI(null)
                }

                // ...
            }
}

Çağrısı Eğer signInWithCredential başarılı kullanabileceğiniz getCurrentUser kullanıcının hesap verilerini almak için yöntem.

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 FirebaseUser nesnesi:

Java

FirebaseUser user = mAuth.getCurrentUser();
String playerName = user.getDisplayName();

// 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 FirebaseUser.getIdToken() instead.
String uid = user.getUid();

Kotlin+KTX

val user = auth.currentUser
user?.let {
    val 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 FirebaseUser.getIdToken() instead.
    val uid = user.uid
}

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 bilgileri veya erişim Play Oyunlar hizmetlerine ulaşmak için sağladığı API'leri kullanmak Google Play Oyunlar SDK .

Bir kullanıcı Oturumu kapatmak için çağrı FirebaseAuth.signOut() :

Java

FirebaseAuth.getInstance().signOut();

Kotlin+KTX

Firebase.auth.signOut()