Android'de Google Play Games Hizmetleri'ni Kullanarak Kimlik Doğrulama

Firebase'de oluşturulan bir Android oyununda oyuncuların oturum açmasını sağlamak için Google Play Games Hizmetleri'ni kullanabilirsiniz. Google Play Games Hizmetleri oturum açma özelliğini Firebase ile kullanmak için önce oyuncunun Google Play Games ile oturum açmasını sağlayın ve bunu yaparken bir OAuth 2.0 kimlik doğrulama kodu isteyin. Ardından, kimlik doğrulama kodunu PlayGamesAuthProvider'e iletin. Böylece, Firebase ile kimlik doğrulama yapmak için kullanabileceğiniz bir Firebase kimlik bilgisi oluşturulur.

Başlamadan önce

Android projenizi oluşturma

  1. Henüz yapmadıysanız Firebase'i Android projenize ekleyin.

  2. Modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) Android için Firebase Authentication kitaplığının bağımlılığını ekleyin. Kitaplık sürümlendirmesini kontrol etmek için Firebase Android BoM simgesini kullanmanızı öneririz.

    Ayrıca, Firebase Authentication'ü ayarlama kapsamında Google Play Hizmetleri SDK'sını uygulamanıza eklemeniz gerekir.

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.7.0"))

    // Add 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 add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.3.0")    
}

    Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

    (Alternatif) BoM

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

    Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için BoM'ı kullanmanızı önemle tavsiye ederiz. Bu, tüm sürümlerin uyumlu olmasını sağlar. 

    dependencies {
    // Add 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:23.1.0")
    
    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.3.0")    
}
         Kotlin'e özgü bir kitaplık modülü mü arıyorsunuz? Ekim 2023'ten (Firebase BoM 32.5.0) itibaren hem Kotlin hem de Java geliştiricileri ana kitaplık modülünden yararlanabilir (ayrıntılar için bu girişimle ilgili SSS bölümüne bakın).

Firebase projenizi ayarlama

  1. Oyununuzun SHA-1 parmak izini Firebase konsolunun Ayarlar sayfasından ayarlayın.

    İmzalama sertifikanızın SHA karmasını gradle signingReport komutuyla alabilirsiniz: 

    ./gradlew signingReport

  2. Google Play Games'i oturum açma sağlayıcısı olarak etkinleştirme:

    1. Projenizin web sunucusu istemci kimliğini ve istemci gizli anahtarı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. Google API'ler Konsolu kimlik bilgileri sayfasında Firebase projenizi 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 sayfada web sunucunuzun istemci kimliği ve gizlisi listelenir.

    2. Ardından Firebase konsolunda Kimlik Doğrulama bölümünü açın.

    3. Oturum açma yöntemi sekmesinde Play Games oturum açma sağlayıcısını etkinleştirin. Projenizin web sunucusu istemci kimliğini ve istemci gizli anahtarını (API'ler konsolundan aldığınız) belirtmeniz gerekir.

Play Games services'ü Firebase uygulama bilgilerinizle yapılandırma

  1. Google Play Console'da Google Play uygulamanızı açın veya oluşturun.

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

  3. Evet, oyunumda zaten Google API'leri kullanılıyor'u tıklayın, listeden Firebase projenizi seçin ve Kullan'ı tıklayın.

  4. Play Games services 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. Bu kimliğin, Play Games oturum açma özelliğini etkinleştirirken belirttiğiniz istemci kimliği olduğundan emin olun.
    3. Yaptığınız değişiklikleri kaydedin.

  5. Play Games services yapılandırma sayfasındayken Kimlik Bilgisi Ekle'yi tekrar 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 Firebase konsolunda oyununuzun SHA-1 parmak izini ayarladığınızdan emin olun.)
    3. Yaptığınız değişiklikleri kaydedin.

  6. Test kullanıcıları sayfasında, oyununuzu Play Store'de yayınlamadan önce oyununuzda oturum açması gereken kullanıcıların e-posta adreslerini ekleyin.

Play Games'de oturum açma özelliğini oyununuza entegre etme

Öncelikle Play Games oturum açma özelliğini uygulamanıza entegre edin. Tam talimatlar için Android Games'de oturum açma başlıklı makaleyi inceleyin.

Entegrasyonunuzda GoogleSignInOptions nesnesini oluştururken DEFAULT_GAMES_SIGN_IN yapılandırmasını kullanın ve requestServerAuthCode'yi çağırın:

Kotlin

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

Java

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

Web sunucunuzun istemci kimliğini requestServerAuthCode yöntemine iletmeniz gerekir. Bu, Firebase konsolunda Play Games oturum açma özelliğini etkinleştirirken sağladığınız kimliktir.

Firebase ile kimlik doğrulama

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

  1. Öncelikle, oturum açma etkinliğinizin onCreate yönteminde FirebaseAuth nesnesinin paylaşılan örneğini alın:

Kotlin

private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.auth
GoogleSignInActivity.kt

Java

private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();
GoogleSignInActivity.java
  1. Etkinliğinizi başlatırken oyuncunun Firebase ile oturum açmış olup olmadığını kontrol edin:

Kotlin

override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}
GoogleSignInActivity.kt

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);
}
GoogleSignInActivity.java
 
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
  1. Bir oyuncu sessiz veya etkileşimli olarak Play Games ile oturum açtıktan sonra GoogleSignInAccount nesnesinden kimlik doğrulama kodunu alın, bunu bir Firebase kimlik bilgisiyle değiştirin ve Firebase kimlik bilgisini kullanarak Firebase ile kimlik doğrulama yapın:

Kotlin

// 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)
            }

            // ...
        }
}
MainActivity.kt

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

                    // ...
                }
            });
}
MainActivity.java

signInWithCredential çağrısı başarılı olursa kullanıcının hesap verilerini almak için getCurrentUser yöntemini kullanabilirsiniz.

Sonraki adımlar

Kullanıcı ilk kez oturum açtığında yeni bir kullanıcı hesabı oluşturulur ve Play Games 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 UID'sini FirebaseUser nesnesinden alabilirsiniz:

Kotlin

val user = auth.currentUser
user?.let {
    val playerName = it.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 = it.uid
}

MainActivity.kt

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();
MainActivity.java

Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda, oturum açmış kullanıcının benzersiz kullanıcı kimliğini auth değişkeninden alabilir ve kullanıcının hangi verilere erişebileceğini kontrol etmek için kullanabilirsiniz.

Kullanıcının Play Games oyuncu bilgilerini almak veya Play Games hizmetlerine erişmek için Google Play Games SDK'sı tarafından sağlanan API'leri kullanın.

Bir kullanıcının oturumunu kapatmak için FirebaseAuth.signOut() işlevini çağırın:

Kotlin

Firebase.auth.signOut()
MainActivity.kt

Java

FirebaseAuth.getInstance().signOut();
MainActivity.java