Możesz używać usług gier Google Play, aby logować graczy w grze na Androida utworzonej w Firebase. Aby używać logowania w usługach gier Google Play za pomocą Firebase, najpierw zaloguj gracza w usługach gier Google Play i poproś o kod uwierzytelniania OAuth 2.0. Następnie przekaż kod uwierzytelniania do PlayGamesAuthProvider, aby wygenerować dane logowania Firebase, których możesz użyć do uwierzytelniania w Firebase.
Zanim zaczniesz
Aby używać logowania przez Google Play Games services w Firebase, wykonaj te czynności:
Konfigurowanie projektu aplikacji na Androida
Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi.
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle) dodaj zależność dla biblioteki Firebase Authentication na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji biblioteki.W ramach konfigurowania Firebase Authentication musisz też dodać do aplikacji pakiet SDK usług Google Play.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.2.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:22.0.0") }Gdy korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Alternatywa) Dodaj zależności biblioteki Firebase bez używania BoM
Jeśli nie zdecydujesz się na użycie Firebase BoM, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Pamiętaj, że jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek, co zapewni zgodność wszystkich wersji.
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:25.0.0")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:22.0.0") }
Konfigurowanie projektu w Firebase
W konsoli Firebase otwórz Zabezpieczenia > Uwierzytelnianie.
Na karcie Ustawienia ustaw odcisk cyfrowy SHA-1 gry.
Skrót SHA certyfikatu podpisywania możesz uzyskać za pomocą polecenia gradle
signingReport:./gradlew signingReport
Włącz Gry Google Play jako dostawcę logowania:
Znajdź identyfikator klienta i tajny klucz klienta serwera WWW projektu. Identyfikator klienta serwera WWW identyfikuje Twój projekt w Firebase na serwerach uwierzytelniania Google Play.
Aby znaleźć te wartości:
- Otwórz projekt w Firebase na stronie danych logowania w konsoli interfejsów API Google.
- W sekcji Identyfikatory klienta OAuth 2.0 otwórz stronę z informacjami o kliencie internetowym (utworzonym automatycznie przez usługę Google). Na tej stronie znajdziesz identyfikator klienta i tajny klucz serwera WWW.
W konsoli Firebase otwórz Bezpieczeństwo > Uwierzytelnianie.
Na karcie Metoda logowania włącz dostawcę logowania Gry Play. Musisz podać identyfikator klienta serwera WWW i tajny klucz klienta projektu, które zostały uzyskane z konsoli Google Cloud.
Skonfiguruj Play Games services, podając informacje o aplikacji w Firebase
W konsoli Google Play otwórz aplikację Google Play lub ją utwórz.
W sekcji Rozwój kliknij Play Games services > Konfiguracja i zarządzanie > Konfiguracja.
Kliknij Tak, w swojej grze używam już interfejsów API Google, wybierz z listy projekt Firebase i kliknij Użyj.
Na stronie konfiguracji Play Games services kliknij Dodaj dane logowania.
- Wybierz typ Serwer gry.
- W polu Klient OAuth wybierz identyfikator klienta usługi internetowej projektu. Upewnij się, że jest to ten sam identyfikator klienta, który został podany podczas włączania logowania się przez Play Games.
- Zapisz zmiany.
Na stronie konfiguracji Play Games services ponownie kliknij Add Credential (Dodaj dane logowania).
- Wybierz typ Android.
- W polu Klient OAuth wybierz identyfikator klienta Androida w projekcie. (Jeśli nie widzisz identyfikatora klienta Androida, upewnij się, że odcisk cyfrowy SHA-1 gry został ustawiony w konsoli Firebase).
- Zapisz zmiany.
Na stronie Testerzy dodaj adresy e-mail użytkowników, którzy muszą mieć możliwość logowania się w grze, zanim zostanie ona opublikowana na platformie Play Store.
Integracja logowania w Grach Play z grą
Najpierw zintegruj logowanie w Grach Play z aplikacją. Więcej informacji znajdziesz w artykule Logowanie się w grach na Androida.
W integracji podczas tworzenia obiektu GoogleSignInOptions użyj konfiguracji DEFAULT_GAMES_SIGN_IN i wywołaj requestServerAuthCode:
Kotlin
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();
Musisz przekazać identyfikator klienta serwera WWW do metody requestServerAuthCode.
Jest to identyfikator podany podczas włączania logowania w Grach Play w konsoli Firebase.
Uwierzytelnianie za pomocą Firebase
Po dodaniu logowania w Grach Play do aplikacji musisz skonfigurować Firebase, aby używać danych logowania na konto Google, które otrzymujesz, gdy gracz pomyślnie zaloguje się w Grach Play.
Najpierw w metodzie
onCreateaktywności logowania pobierz udostępnioną instancję obiektuFirebaseAuth:Kotlin
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
Podczas inicjowania aktywności sprawdź, czy gracz jest już zalogowany w Firebase:
Kotlin
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); }
Jeśli gracz nie jest zalogowany, wyświetl mu interfejs gry dla niezalogowanych użytkowników, w tym opcję logowania.
Gdy gracz zaloguje się w Grach Play w trybie cichym lub interaktywnym, pobierz kod uwierzytelniający z obiektu
GoogleSignInAccount, wymień go na dane logowania Firebase i uwierzytelnij się w Firebase za pomocą tych danych: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) } // ... } }
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); } // ... } }); }
Jeśli wywołanie metody
signInWithCredentialsię powiedzie, możesz użyć metodygetCurrentUser, aby uzyskać dane konta użytkownika.
Dalsze kroki
Gdy użytkownik zaloguje się po raz pierwszy, zostanie utworzone nowe konto użytkownika i połączone z jego identyfikatorem w Grach Play. To nowe konto jest przechowywane w projekcie w Firebase i może służyć do identyfikowania użytkownika we wszystkich aplikacjach w projekcie.
W grze możesz uzyskać identyfikator Firebase UID użytkownika z obiektu FirebaseUser:
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 }
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();
W regułach zabezpieczeń Bazy danych czasu rzeczywistego Firebase i Cloud Storage możesz pobrać unikalny identyfikator zalogowanego użytkownika ze zmiennej auth i użyć go do kontrolowania, do jakich danych użytkownik ma dostęp.
Aby uzyskać informacje o graczu w Grach Play lub uzyskać dostęp do usług Gier Play, użyj interfejsów API udostępnianych przez pakiet SDK Gier Google Play.
Aby wylogować użytkownika, wywołaj FirebaseAuth.signOut:
Kotlin
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();