Mit den Google Play-Spieldiensten auf Android-Geräten authentifizieren

Sie können die Google Play-Spieldienste verwenden, um Spieler in einem Android-Spiel anzumelden, das auf Firebase basiert. Wenn Sie die Anmeldung bei Google Play Games-Diensten mit Firebase verwenden möchten, melden Sie den Spieler zuerst bei Google Play Games an und fordern Sie dabei einen OAuth 2.0-Autorisierungscode an. Übergeben Sie dann den Autorisierungscode an PlayGamesAuthProvider, um ein Firebase-Anmeldedatenobjekt zu generieren, mit dem Sie sich bei Firebase authentifizieren können.

Hinweis

Führen Sie die folgenden Einrichtungsschritte aus, um die Google Play Games services-Anmeldung mit Firebase zu verwenden:

Android-Projekt einrichten

  1. Falls noch nicht geschehen, fügen Sie Ihrem Android-Projekt Firebase hinzu.

  2. Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die Firebase Authentication-Bibliothek für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Bibliotheksversionierung zu steuern.

    Im Rahmen der Einrichtung von Firebase Authentication müssen Sie Ihrer App auch das Google Play-Dienste SDK hinzufügen.

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

    Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

    (Alternative)  Firebase-Bibliotheksabhängigkeiten ohne Verwendung der BoM hinzufügen

    Wenn Sie die Firebase BoM nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in der entsprechenden Abhängigkeitszeile angeben.

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die BoM zur Verwaltung der Bibliotheksversionen zu verwenden. So wird sichergestellt, dass alle Versionen kompatibel sind.

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

Das Firebase-Projekt einrichten

  1. Rufen Sie in der Firebase-Konsole Sicherheit > Authentifizierung auf.

  2. Legen Sie auf dem Tab Einstellungen den SHA-1-Fingerabdruck Ihres Spiels fest.

    Sie können den SHA-Hash Ihres Signaturzertifikats mit dem Gradle-Befehl signingReport abrufen:

    ./gradlew signingReport

  3. Aktivieren Sie Google Play Spiele als Anmeldeanbieter:

    1. Suchen Sie die Webserver-Client-ID und den Clientschlüssel Ihres Projekts. Die Webserver-Client-ID identifiziert Ihr Firebase-Projekt bei den Google Play-Authentifizierungsservern.

      So ermitteln Sie diese Werte:

      1. Öffnen Sie Ihr Firebase-Projekt auf der Seite „Anmeldedaten“ der Google APIs Console.
      2. Öffnen Sie im Abschnitt OAuth 2.0-Client-IDs die Detailseite Webclient (von Google Service erstellt). Auf dieser Seite werden die Client-ID und der Clientschlüssel Ihres Webservers aufgeführt.
    2. Kehren Sie zur Firebase-Konsole zurück und rufen Sie Sicherheit > Authentifizierung auf.

    3. Aktivieren Sie auf dem Tab Anmeldemethode den Anmeldeanbieter Play Spiele. Sie müssen die Webserver-Client-ID und den Clientschlüssel Ihres Projekts angeben, die Sie in der Google Cloud-Konsole erhalten haben.

Play Games services mit den Informationen zu Ihrer Firebase-App konfigurieren

  1. Öffnen Sie in der Google Play Console Ihre Google Play-Anwendung oder erstellen Sie eine.

  2. Klicken Sie im Bereich Wachstum auf Play Games services > Einrichtung und Verwaltung > Konfiguration.

  3. Klicken Sie auf Ja, in meinem Spiel kommen bereits Google-APIs zum Einsatz, wählen Sie Ihr Firebase-Projekt aus der Liste aus und klicken Sie dann auf Verwenden.

  4. Klicken Sie auf der Konfigurationsseite Play Games services auf Anmeldedaten hinzufügen.

    1. Wählen Sie den Typ Spieleserver aus.
    2. Wählen Sie im Feld OAuth-Client die Webclient-ID Ihres Projekts aus. Achten Sie darauf, dass dies dieselbe Client-ID ist, die Sie bei der Aktivierung der Anmeldung mit Play Games angegeben haben.
    3. Speichern Sie die Änderungen.
  5. Klicken Sie auf der Konfigurationsseite Play Games services noch einmal auf Anmeldedaten hinzufügen.

    1. Wählen Sie den Typ Android aus.
    2. Wählen Sie im Feld OAuth-Client die Android-Client-ID Ihres Projekts aus. Wenn Sie Ihre Android-Client-ID nicht sehen, prüfen Sie, ob Sie den SHA-1-Fingerabdruck Ihres Spiels in der Firebase Console festgelegt haben.
    3. Speichern Sie die Änderungen.
  6. Füge auf der Seite Tester die E‑Mail-Adressen aller Nutzer hinzu, die sich vor der Veröffentlichung im Play Store in deinem Spiel anmelden können sollen.

Google Play Games-Anmeldung in Ihr Spiel einbinden

Binde zuerst die Anmeldung bei Play Spiele in deine App ein. Weitere Informationen findest du unter In Android-Spielen anmelden.

Verwenden Sie in Ihrer Integration beim Erstellen des GoogleSignInOptions-Objekts die DEFAULT_GAMES_SIGN_IN-Konfiguration und rufen Sie requestServerAuthCode auf:

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

Sie müssen die Client-ID Ihres Webservers an die Methode requestServerAuthCode übergeben. Dies ist die ID, die Sie angegeben haben, als Sie die Anmeldung bei Play Spiele in der Firebase Console aktiviert haben.

Mit Firebase authentifizieren

Nachdem du die Anmeldung bei Google Play-Spielen zu deiner App hinzugefügt hast, musst du Firebase so einrichten, dass die Google-Kontoanmeldedaten verwendet werden, die du erhältst, wenn sich ein Spieler erfolgreich bei Google Play-Spielen anmeldet.

  1. Rufen Sie zuerst in der onCreate-Methode Ihrer Anmeldeaktivität die freigegebene Instanz des FirebaseAuth-Objekts ab:

    Kotlin

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

    Java

    private FirebaseAuth mAuth;
    // ...
    // Initialize Firebase Auth
    mAuth = FirebaseAuth.getInstance();
  2. Prüfe beim Initialisieren deiner Aktivität, ob der Spieler bereits mit Firebase angemeldet ist:

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

    Wenn der Spieler nicht angemeldet ist, präsentiere ihm die abgemeldete Version deines Spiels, einschließlich der Option, sich anzumelden.

  3. Nachdem sich ein Spieler entweder im Hintergrund oder interaktiv bei Play Spiele angemeldet hat, rufen Sie den Autorisierungscode aus dem GoogleSignInAccount-Objekt ab, tauschen ihn gegen Firebase-Anmeldedaten ein und authentifizieren sich mit den Firebase-Anmeldedaten bei Firebase:

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

    Wenn der Aufruf von signInWithCredential erfolgreich ist, kannst du die Methode getCurrentUser verwenden, um die Kontodaten des Nutzers abzurufen.

Nächste Schritte

Nachdem sich ein Nutzer zum ersten Mal angemeldet hat, wird ein neues Nutzerkonto erstellt und mit seiner Play Spiele-ID verknüpft. Dieses neue Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um einen Nutzer in allen Apps Ihres Projekts zu identifizieren.

In Ihrem Spiel können Sie die Firebase-UID des Nutzers aus dem FirebaseUser-Objekt abrufen:

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

In den Sicherheitsregeln für Firebase Realtime Database und Cloud Storage können Sie die eindeutige Nutzer-ID des angemeldeten Nutzers aus der Variablen auth abrufen und damit steuern, auf welche Daten ein Nutzer zugreifen kann.

Wenn Sie die Spielerinformationen eines Nutzers in Google Play Spiele abrufen oder auf die Google Play-Spieledienste zugreifen möchten, verwenden Sie die APIs, die im Google Play Games SDK bereitgestellt werden.

Wenn Sie einen Nutzer abmelden möchten, rufen Sie FirebaseAuth.signOut auf:

Kotlin

Firebase.auth.signOut()

Java

FirebaseAuth.getInstance().signOut();