Bevor Sie beginnen
Bevor Sie die Firebase-Authentifizierung verwenden können, müssen Sie Folgendes tun:
- Registrieren Sie Ihr Unity-Projekt bei Ihrem Firebase-Projekt.
- Fügen Sie das Firebase Unity SDK (insbesondere
FirebaseAuth.unitypackage
) zu Ihrem Unity-Projekt hinzu.
Ausführliche Anweisungen für diese ersten Einrichtungsschritte finden Sie unter Hinzufügen von Firebase zu Ihrem Unity-Projekt .
- Holen Sie sich die Serverschlüssel Ihres Projekts:
- Rufen Sie in den Einstellungen Ihres Projekts die Seite „ Dienstkonten “ auf.
- Klicken Sie unten im Abschnitt „ Firebase Admin SDK “ auf der Seite „ Dienstkonten “ auf „ Neuen privaten Schlüssel generieren “.
- Das öffentliche/private Schlüsselpaar des neuen Dienstkontos wird automatisch auf Ihrem Computer gespeichert. Kopieren Sie diese Datei auf Ihren Authentifizierungsserver.
Authentifizieren Sie sich mit Firebase
DieFirebaseAuth
-Klasse ist das Gateway für alle API-Aufrufe. Es ist über FirebaseAuth.DefaultInstance zugänglich.Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
Rufen Sie Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync
mit dem Token von Ihrem Authentifizierungsserver auf.
- Wenn sich Benutzer bei Ihrer App anmelden, senden Sie ihre Anmeldeinformationen (z. B. ihren Benutzernamen und ihr Kennwort) an Ihren Authentifizierungsserver. Ihr Server überprüft die Anmeldeinformationen und gibt ein benutzerdefiniertes Token zurück, wenn sie gültig sind.
- Nachdem Sie das benutzerdefinierte Token von Ihrem Authentifizierungsserver erhalten haben, übergeben Sie es an
Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync
, um den Benutzer anzumelden:auth.SignInWithCustomTokenAsync(custom_token).ContinueWith(task => { if (task.IsCanceled) { Debug.LogError("SignInWithCustomTokenAsync was canceled."); return; } if (task.IsFaulted) { Debug.LogError("SignInWithCustomTokenAsync encountered an error: " + task.Exception); return; } Firebase.Auth.AuthResult result = task.Result; Debug.LogFormat("User signed in successfully: {0} ({1})", result.User.DisplayName, result.User.UserId); });
Nächste Schritte
Nachdem sich ein Benutzer zum ersten Mal angemeldet hat, wird ein neues Benutzerkonto erstellt und mit den Anmeldeinformationen verknüpft – d. h. dem Benutzernamen und Kennwort, der Telefonnummer oder den Authentifizierungsanbieterinformationen –, mit denen sich der Benutzer angemeldet hat. Dieses neue Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um einen Benutzer in jeder App in Ihrem Projekt zu identifizieren, unabhängig davon, wie sich der Benutzer anmeldet.
In Ihren Apps können Sie die grundlegenden Profilinformationen des Benutzers aus dem
Firebase.Auth.FirebaseUser
-Objekt abrufen:Firebase.Auth.FirebaseUser user = auth.CurrentUser; if (user != null) { string name = user.DisplayName; string email = user.Email; System.Uri photo_url = user.PhotoUrl; // 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 User.TokenAsync() instead. string uid = user.UserId; }
In Ihren Sicherheitsregeln für die Firebase-Echtzeitdatenbank und den Cloud-Speicher können Sie die eindeutige Benutzer-ID des angemeldeten Benutzers aus der Variablen
auth
und damit steuern, auf welche Daten ein Benutzer zugreifen kann.
Sie können Benutzern erlauben, sich mit mehreren Authentifizierungsanbietern bei Ihrer App anzumelden, indem Sie die Anmeldeinformationen des Authentifizierungsanbieters mit einem vorhandenen Benutzerkonto verknüpfen.
Um einen Benutzer abzumelden, rufen SignOut()
:
auth.SignOut();