Inizia a utilizzare Firebase Authentication in C++

Puoi utilizzare Firebase Authentication per consentire agli utenti di accedere alla tua app utilizzando uno o più metodi di accesso, tra cui l'accesso con indirizzo email e password e i provider di identità federata come Accedi con Google e Accesso con Facebook. Questo tutorial ti aiuta a iniziare a utilizzare Firebase Authentication mostrandoti come aggiungere l'accesso con indirizzo email e password alla tua app.

Connettere il progetto C++ a Firebase

Prima di poter utilizzare Firebase Authentication, devi:

  • Registra il tuo progetto C++ e configuralo in modo che utilizzi Firebase.

    Se il tuo progetto C++ utilizza già Firebase, è 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 sia nel progetto C++ aperto (ad esempio, scarichi i file di configurazione Firebase dalla console, poi li sposti nel progetto C++).

Registrare nuovi utenti

Crea un modulo che consenta ai nuovi utenti di registrarsi alla tua app utilizzando il loro indirizzo email e una password. Quando un utente compila 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 un callback 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 Future:

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

In alternativa, per utilizzare il polling, esegui un'operazione simile all'esempio seguente nel ciclo di aggiornamento del 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());
  }
}

Accedere per gli utenti esistenti

Crea un modulo che consenta agli utenti esistenti di accedere utilizzando il proprio indirizzo email e la propria 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 della registrazione.

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

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

Crea il listener implementando la classe astratta firebase::auth::AuthStateListener. Ad esempio, per creare un listener che recuperi informazioni sull'utente quando esegue l'accesso:

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

Passaggi successivi

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