開始使用 C++ 中的 Firebase 驗證

只要使用 Firebase Authentication，就能讓使用者用您的帳戶登入應用程式 以及更多登入方式，包括電子郵件地址和密碼登入 聯合識別資訊提供者，例如 Google 登入和 Facebook 登入。這個 教學課程可協助您開始使用 Firebase Authentication，並說明如何新增 電子郵件地址和密碼登入應用程式。

將 C++ 專案連結至 Firebase

使用前 Firebase Authentication、 請完成下列操作：

  • 註冊 C++ 專案，並將其設為使用 Firebase。

    如果您的 C++ 專案已使用 Firebase，表示該專案已註冊， 設定 Firebase 專屬的容器

  • 在 C++ 專案中新增 Firebase C++ SDK。

，瞭解如何調查及移除這項存取權。

請注意，將 Firebase 新增至 C++ 專案時，需要執行 Firebase 控制台，然後在開啟的 C++ 專案中 (例如，下載 控制台中的 Firebase 設定檔，然後將這些檔案移至 C++ 專案)。

註冊新使用者

建立表單，讓新使用者使用 電子郵件地址和密碼。使用者填妥表單後， 電子郵件地址和密碼，然後將這些資訊傳遞至 CreateUserWithEmailAndPassword 方法：

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

您可以註冊 CreateUserWithEmailAndPasswordLastResult Future 物件的回呼，或是 如果您編寫的是具有定期更新迴圈的遊戲或應用程式， 在更新迴圈中輪詢狀態。

例如，使用 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);

如要使用意見調查功能，請在遊戲的 更新迴圈：

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

登入現有使用者

建立表單，讓現有使用者透過他們的電子郵件地址登入 和密碼。使用者填妥表單時，請呼叫 SignInWithEmailAndPassword 方法：

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

取得登入作業的結果，與取得註冊結果的方式相同。

設定驗證狀態監聽器並取得帳戶資料

如要回應登入和登出事件，請將事件監聽器附加至全域 驗證物件使用者登入時，系統就會呼叫這個事件監聽器 狀態變更。因為監聽器只會在驗證物件 而且在完成所有網路呼叫後 來取得登入使用者的相關資訊。

實作 firebase::auth::AuthStateListener 來建立事件監聽器 抽象類別。舉例來說，如要建立事件監聽器來取得 使用者成功登入時：

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

使用 firebase::auth::Auth 物件的 AddAuthStateListener 方法：

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

後續步驟

瞭解如何新增對其他識別資訊提供者和匿名訪客的支援 帳戶：