Google Play Oyun Hizmetleri'ni kullanarak oyuncuların Firebase'de oluşturulmuş bir Android oyununda oturum açmalarını sağlayabilirsiniz. Google Play Games hizmetlerinde Firebase ile oturum açma özelliğini kullanmak için önce oyuncunun Google Play Games ile oturum açmasını sağlayın ve bu işlemi yaptığınızda OAuth 2.0 yetkilendirme kodu isteyin. Ardından, Firebase ile kimlik doğrulamak için kullanabileceğiniz bir Firebase kimlik bilgisi oluşturmak üzere yetkilendirme kodunu PlayGamesAuthProvider
adlı iş ortağına iletin.
Başlamadan önce
Android projenizi oluşturma
Henüz yapmadıysanız Firebase'i Android projenize ekleyin.
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ığına bağımlılığı ekleyin. Kitaplık sürümü oluşturmayı kontrol etmek için Firebase Android BoM'u kullanmanızı öneririz.Ayrıca, Firebase Authentication'ı ayarlamanın bir parçası olarak 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.1.1")) // 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.2.0") }Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının her zaman uyumlu sürümlerini kullanır.
(Alternatif) Firebase kitaplığı bağımlılıklarını BoM'u kullanmadan ekleyin
Firebase BoM'yi 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 tüm sürümlerin uyumlu olmasını sağlamak için BoM kullanmanızı kesinlikle öneririz.
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.0.0")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:21.2.0") }
Firebase projenizi oluşturma
Oyununuzun SHA-1 parmak izini Firebase konsolunun Ayarlar sayfasından ayarlayın.
İmza sertifikanızın SHA karmasını gradle
signingReport
komutuyla alabilirsiniz:./gradlew signingReport
Google Play Games'i oturum açma sağlayıcısı olarak etkinleştirin:
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:
- Google API'leri konsolu kimlik bilgileri sayfasında Firebase projenizi açın.
- 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 sunucusu istemci kimliğiniz ve gizli anahtarınız listelenir.
Ardından Firebase konsolunda Kimlik Doğrulama bölümünü açın.
Oturum açma yöntemi sekmesinde Play Games oturum açma sağlayıcısını etkinleştirin. Projenizin API'ler konsolundan aldığınız web sunucusu istemci kimliğini ve istemci gizli anahtarını belirtmeniz gerekir.
Play Games hizmetlerini Firebase uygulama bilgilerinizle yapılandırma
Google Play Console'da Google Play uygulamanızı açın veya bir tane oluşturun.
Büyüme bölümünde Play Games hizmetleri > Kurulum ve Yönetim > Yapılandırma'yı tıklayın.
Evet, oyunumda zaten Google API'leri kullanılıyor'u tıklayın, listeden Firebase projenizi seçin ve Kullan'ı tıklayın.
Play Games hizmetleri yapılandırma sayfasında Kimlik Bilgisi Ekle'yi tıklayın.
- Oyun sunucusu türünü seçin.
- OAuth istemcisi alanında projenizin web istemcisi kimliğini seçin. Bu kimliğin, Play Games ile oturum açmayı etkinleştirdiğinizde belirttiğiniz istemci kimliğiyle aynı olduğundan emin olun.
- Yaptığınız değişiklikleri kaydedin.
Yine Play Games hizmetleri yapılandırma sayfasında Kimlik Bilgisi Ekle'yi tekrar tıklayın.
- Android türünü seçin.
- 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.)
- Yaptığınız değişiklikleri kaydedin.
Test kullanıcıları sayfasında, oyununuzu Play Store'da yayınlamadan önce oyununuzda oturum açabilmesi gereken kullanıcıların e-posta adreslerini ekleyin.
Play Games oturum açma bilgilerini oyununuza entegre edin
Öncelikle, Play Games oturum açma özelliğini uygulamanıza entegre edin. Talimatların tamamı için Android Games'de oturum açma başlıklı makaleye bakın.
Entegrasyonunuzda GoogleSignInOptions
nesnesini oluştururken DEFAULT_GAMES_SIGN_IN
yapılandırmasını kullanın ve requestServerAuthCode
öğesini çağırın:
Kotlin+KTX
val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN) .requestServerAuthCode(getString(R.string.default_web_client_id)) .build()
Java
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN) .requestServerAuthCode(getString(R.string.default_web_client_id)) .build();
Web sunucusu istemci kimliğinizi requestServerAuthCode
yöntemine iletmeniz gerekir.
Bu, Firebase konsolunda Play Games ile oturum açmayı etkinleştirirken sağladığınız kimliktir.
Firebase ile kimlik doğrulama
Uygulamanıza Play Games oturum açma bilgilerini ekledikten sonra, bir oyuncu Play Games ile başarılı bir şekilde oturum açtığında aldığınız Google hesabı kimlik bilgilerini kullanmak için Firebase'i ayarlamanız gerekir.
- Öncelikle, oturum açma etkinliğinizin
onCreate
yöntemindeFirebaseAuth
nesnesinin paylaşılan örneğini alın:
Kotlin+KTX
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
- Etkinliğinizi başlatırken oynatıcının Firebase ile oturum açmış olup olmadığını kontrol edin:
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) }
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); }
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
- Oyuncu, Play Games'de sessiz veya etkileşimli olarak oturum açtıktan sonra
GoogleSignInAccount
nesnesinden yetkilendirme kodunu alın, bu kodu Firebase kimlik bilgisiyle değiştirin ve Firebase kimlik bilgisini kullanarak Firebase ile kimlik doğrulayın:
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) } // ... } }
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); } // ... } }); }
signInWithCredential
çağrısı başarılı olursa kullanıcının hesap verilerini almak için getCurrentUser
yöntemini kullanabilirsiniz.
Sonraki adımlar
Bir kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve Play Games Kimliği'ne 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+KTX
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 }
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();
Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda, oturum açan kullanıcının benzersiz kullanıcı kimliğini auth
değişkeninden alabilir ve bir kullanıcının erişebileceği verileri 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()
numaralı telefonu arayın:
Kotlin+KTX
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();