Pierwsze kroki z Uwierzytelnianiem Firebase w C++

Możesz używać uwierzytelniania Firebase, aby zezwolić użytkownikom na logowanie się w aplikacji za pomocą co najmniej jednej metody logowania, w tym logowania za pomocą adresu e-mail i hasła, oraz dostawców tożsamości sfederowanych, takich jak Logowanie przez Google i Logowanie przez Facebooka. Z tego samouczka dowiesz się, jak dodać do aplikacji uwierzytelnianie Firebase za pomocą adresu e-mail i hasła.

Połącz swój projekt w C++ z Firebase

Zanim zaczniesz korzystać z Uwierzytelniania Firebase, musisz:

  • Zarejestruj swój projekt C++ i skonfiguruj go pod kątem korzystania z Firebase.

    Jeśli Twój projekt C++ korzysta już z Firebase, oznacza to, że jest już zarejestrowany i skonfigurowany dla Firebase.

  • Dodaj pakiet SDK Firebase C++ do projektu w C++.

Pamiętaj, że dodanie Firebase do projektu C++ wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie C++ (np. musisz pobrać pliki konfiguracyjne Firebase z konsoli, a następnie przenieść je do projektu C++).

Zarejestruj nowych użytkowników

Utwórz formularz, który umożliwia nowym użytkownikom rejestrowanie się w aplikacji za pomocą adresu e-mail i hasła. Gdy użytkownik wypełni formularz, sprawdź poprawność adresu e-mail i hasła podanych przez niego, a następnie przekaż je do metody CreateUserWithEmailAndPassword:

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

Stan procesu tworzenia konta możesz sprawdzić, rejestrując wywołanie zwrotne obiektu CreateUserWithEmailAndPasswordLastResult Future albo, jeśli tworzysz grę lub aplikację z jakąś okresową pętlą aktualizacji, sprawdzając stan w pętli aktualizacji.

Na przykład użycie przyszłości:

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

Jeśli chcesz używać ankiet, wykonaj w pętli aktualizacji gry coś podobnego do tego przykładu:

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

Logowanie istniejących użytkowników

Utwórz formularz, który umożliwia dotychczasowym użytkownikom logowanie się za pomocą adresu e-mail i hasła. Gdy użytkownik wypełni formularz, wywołaj metodę SignInWithEmailAndPassword:

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

Uzyskaj wynik operacji logowania w taki sam sposób jak wynik rejestracji.

Ustawianie detektora stanu uwierzytelniania i pobieranie danych konta

Aby odpowiadać na zdarzenia logowania i wylogowania, podłącz detektor do globalnego obiektu uwierzytelniania. Ten detektor jest wywoływany po każdej zmianie stanu logowania użytkownika. Ponieważ odbiornik działa dopiero po całkowitym zainicjowaniu obiektu uwierzytelniania i po zakończeniu wywołań sieciowych, najlepszym sposobem na uzyskanie informacji o zalogowanym użytkowniku jest uzyskanie informacji o zalogowanym użytkowniku.

Utwórz detektor, implementując klasę abstrakcyjną firebase::auth::AuthStateListener. Aby na przykład utworzyć detektor, który odbiera informacje o użytkowniku, gdy się on zaloguje:

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

Dołącz odbiornik za pomocą metody AddAuthStateListener obiektu firebase::auth::Auth:

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

Dalsze kroki

Dowiedz się, jak dodać obsługę innych dostawców tożsamości i anonimowych kont gości: