Firebase üzerinde oluşturulmuş bir Android oyununda oyuncuların oturumunu açmak için Google Play Oyunlar hizmetlerini kullanabilirsiniz. Google Play Oyunlar hizmetlerini kullanmak için Firebase ile oturum açın, önce oynatıcıda Google Play Oyunlar'da oturum açın ve bunu yaptığınızda bir OAuth 2.0 auth kodu isteyin. Ardından, Firebase ile kimlik doğrulaması yapmak için kullanabileceğiniz bir Firebase kimlik bilgisi oluşturmak için kimlik doğrulama kodunu PlayGamesAuthProvider
iletin.
Sen başlamadan önce
Android projenizi kurun
Henüz yapmadıysanız, Firebase'i Android projenize ekleyin .
Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Firebase Authentication için bağımlılığı ekleyin Android kitaplığı. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.Ayrıca Firebase Authentication kurulumunun bir parçası olarak Google Play hizmetleri SDK'sını uygulamanıza eklemeniz gerekir.
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.3.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-ktx")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:20.7.0") }Firebase Android BoM'yi kullandığınızda, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
(Alternatif) BoM kullanmadan Firebase kitaplığı bağımlılıkları ekleyin
Firebase BoM'yi kullanmamayı seçerseniz, her bir Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi 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-ktx:22.1.2")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:20.7.0") }Java
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.3.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:20.7.0") }Firebase Android BoM'yi kullandığınızda, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
(Alternatif) BoM kullanmadan Firebase kitaplığı bağımlılıkları ekleyin
Firebase BoM'yi kullanmamayı seçerseniz, her bir Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi 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:22.1.2")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:20.7.0") }
Firebase projenizi kurun
Firebase konsolunun Ayarlar sayfasından oyununuzun SHA-1 parmak izini ayarlayın.
İmza sertifikanızın SHA karmasını
signingReport
komutuyla alabilirsiniz:./gradlew signingReport
Oturum açma sağlayıcısı olarak Google Play Games'i etkinleştirin:
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:
- Firebase projenizi Google API'leri konsol kimlik bilgileri sayfasında açın.
- OAuth 2.0 istemci kimlikleri bölümünde, Web istemcisi (Google Hizmeti tarafından otomatik oluşturulan) ayrıntılar sayfasını açın. Bu sayfa, web sunucusu istemci kimliğinizi ve sırrınızı listeler.
Ardından, Firebase konsolunda Kimlik Doğrulama bölümünü açın.
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.
Play Oyunlar hizmetlerini Firebase uygulama bilgilerinizle yapılandırın
Google Play Console'da Google Play uygulamanızı açın veya bir tane oluşturun.
Büyüme bölümünde, Play Oyunlar hizmetleri > Kurulum ve Yönetim > Yapılandırma 'yı tıklayın.
Evet, oyunum zaten Google API'lerini kullanıyor seçeneğine tıklayın, listeden Firebase projenizi seçin ve ardından Kullan seçeneğine tıklayın.
Play Oyunlar 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. Bunun, Play Oyunlar'da oturum açmayı etkinleştirirken belirttiğiniz müşteri kimliğinin aynısı olduğundan emin olun.
- Değişikliklerinizi kaydedin.
Yine Play Oyunlar 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.)
- Değişikliklerinizi kaydedin.
Test Kullanıcıları 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 bilgilerini oyununuza entegre edin
Öncelikle, Play Oyunlar oturum açma bilgilerini uygulamanıza entegre edin. Talimatların tamamı için Android Oyunlarında Oturum Açma bölümüne bakın.
Entegrasyonunuzda, GoogleSignInOptions
nesnesini oluştururken DEFAULT_GAMES_SIGN_IN
yapılandırmasını kullanın ve requestServerAuthCode
ç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 iletmelisiniz. Bu, Firebase konsolunda Play Oyunlar'da oturum açmayı etkinleştirdiğinizde sağladığınız kimliktir.
Firebase ile kimlik doğrulaması yapın
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 kullanmak için Firebase'i kurmanız gerekir.
- İlk olarak, oturum açma etkinliğinizin
onCreate
yönteminde,FirebaseAuth
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();
- Aktivitenizi başlatırken, oyuncunun zaten 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.
- Bir oyuncu Play Games'te sessiz veya etkileşimli olarak oturum açtıktan sonra
GoogleSignInAccount
nesnesinden kimlik doğrulama kodunu alın, bunu bir Firebase kimlik bilgisi ile değiştirin ve Firebase kimlik bilgilerini kullanarak Firebase ile kimlik doğrulaması yapı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ğine bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak saklanı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 Gerçek Zamanlı Veritabanı ve Bulut Depolama Güvenlik Kurallarınızda, oturum açmış 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 Google Play Oyunlar SDK'sı tarafından sağlanan API'leri kullanın.
Bir kullanıcının oturumunu kapatmak için FirebaseAuth.signOut()
öğesini arayın:
Kotlin+KTX
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();