Inizia con l'autenticazione Firebase in C++

Puoi utilizzare l'autenticazione Firebase per consentire agli utenti di accedere alla tua app utilizzando uno o più metodi di accesso, tra cui l'accesso tramite indirizzo e-mail e password, e provider di identità federati come Accesso Google e Accesso Facebook. Questo tutorial ti introduce all'autenticazione Firebase mostrandoti come aggiungere l'indirizzo email e l'accesso tramite password alla tua app.

Collega il tuo progetto C++ a Firebase

Prima di poter utilizzare l'autenticazione Firebase , devi:

  • Registra il tuo progetto C++ e configuralo per utilizzare Firebase.

    Se il tuo progetto C++ utilizza già Firebase, significa che è già registrato e configurato per Firebase.

  • Aggiungi l' SDK Firebase C++ al tuo progetto C++.

Tieni presente che l'aggiunta di Firebase al tuo progetto C++ comporta attività sia nella console Firebase che nel tuo progetto C++ aperto (ad esempio, scarichi i file di configurazione Firebase dalla console, quindi li sposti nel tuo progetto C++).

Iscrivi nuovi utenti

Crea un modulo che consenta ai nuovi utenti di registrarsi alla tua app utilizzando il proprio indirizzo email e una password. Quando un utente completa il modulo, convalida l'indirizzo email e la password forniti dall'utente, quindi passali al metodo CreateUserWithEmailAndPassword :

firebase::Future<firebase::auth::AuthResult> result =
    auth->CreateUserWithEmailAndPassword(email, password);

Puoi controllare lo stato dell'operazione di creazione dell'account registrando una richiamata sull'oggetto CreateUserWithEmailAndPasswordLastResult Future oppure, se stai scrivendo un gioco o un'app con una sorta di ciclo di aggiornamento periodico, eseguendo il polling dello stato nel ciclo di aggiornamento.

Ad esempio, utilizzando un futuro:

firebase::Future<firebase::auth::AuthResult> result =
    auth->CreateUserWithEmailAndPasswordLastResult();

// The lambda has the same signature as the callback function.
result.OnCompletion(
    [](const firebase::Future<firebase::auth::AuthResult>& result,
       void* user_data) {
      // `user_data` is the same as &my_program_context, below.
      // Note that we can't capture this value in the [] because std::function
      // is not supported by our minimum compiler spec (which is pre C++11).
      MyProgramContext* program_context =
          static_cast<MyProgramContext*>(user_data);

      // Process create user result...
      (void)program_context;
    },
    &my_program_context);

Oppure, per utilizzare il polling, esegui qualcosa di simile al seguente esempio nel ciclo di aggiornamento del tuo gioco:

firebase::Future<firebase::auth::AuthResult> result =
    auth->CreateUserWithEmailAndPasswordLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::AuthResult* auth_result = *result.result();
    printf("Create user succeeded for email %s\n", auth_result.user.email().c_str());
  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

Accedi agli utenti esistenti

Crea un modulo che consenta agli utenti esistenti di accedere utilizzando il proprio indirizzo email e la password. Quando un utente completa il modulo, chiama il metodo SignInWithEmailAndPassword :

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithEmailAndPassword(email, password);

Ottieni il risultato dell'operazione di accesso nello stesso modo in cui hai ottenuto il risultato dell'iscrizione.

Imposta un listener dello stato di autenticazione e ottieni i dati dell'account

Per rispondere agli eventi di accesso e disconnessione, collega un ascoltatore all'oggetto di autenticazione globale. Questo ascoltatore viene chiamato ogni volta che cambia lo stato di accesso dell'utente. Poiché il listener viene eseguito solo dopo che l'oggetto di autenticazione è stato completamente inizializzato e dopo il completamento di tutte le chiamate di rete, è il posto migliore per ottenere informazioni sull'utente che ha effettuato l'accesso.

Crea il listener implementando la classe astratta firebase::auth::AuthStateListener . Ad esempio, per creare un ascoltatore che ottiene informazioni sull'utente quando un utente accede correttamente:

class MyAuthStateListener : public firebase::auth::AuthStateListener {
 public:
  void OnAuthStateChanged(firebase::auth::Auth* auth) override {
    firebase::auth::User user = auth.current_user();
    if (user.is_valid()) {
      // User is signed in
      printf("OnAuthStateChanged: signed_in %s\n", user.uid().c_str());
      const std::string displayName = user.DisplayName();
      const std::string emailAddress = user.Email();
      const std::string photoUrl = user.PhotoUrl();
    } else {
      // User is signed out
      printf("OnAuthStateChanged: signed_out\n");
    }
    // ...
  }
};

Collega il listener con il metodo AddAuthStateListener dell'oggetto firebase::auth::Auth :

MyAuthStateListener state_change_listener;
auth->AddAuthStateListener(&state_change_listener);

Prossimi passi

Scopri come aggiungere il supporto per altri provider di identità e account ospite anonimi: