使用 Unity 以匿名方式向 Firebase 驗證

您可以透過 Firebase Authentication 建立及使用臨時匿名帳戶,向 Firebase 驗證身分。這些臨時匿名帳戶可供尚未註冊應用程式的使用者使用,以便處理受安全性規則保護的資料。如果匿名使用者決定註冊應用程式,您可以將登入憑證連結至匿名帳戶,讓他們在日後的工作階段中繼續使用受保護的資料。

事前準備

  1. 如要使用 Firebase Authentication,請先將 Firebase Unity SDK (具體來說是 FirebaseAuth.unitypackage) 新增至 Unity 專案。

    如需這些初始設定步驟的詳細操作說明,請參閱「將 Firebase 新增至 Unity 專案」一文。

  2. 如果尚未將應用程式連結至 Firebase 專案,請從 Firebase 控制台進行連結。
  3. 啟用匿名驗證:
    1. 在 Firebase 控制台中,依序前往「安全性」 >「驗證」。
    2. 在「登入方式」分頁中,啟用「匿名」登入供應商。
    3. 選用:如果已將專案升級至 Firebase Authentication with Identity Platform,可以啟用自動清除功能。啟用這項設定後,系統就會自動刪除建立至今超過 30 天的匿名帳戶。如果專案已啟用自動清除功能,匿名驗證就不會計入用量限制或計費配額。請參閱「自動清除」。

以匿名方式向 Firebase 進行驗證

如果使用者未登入,但使用需要透過 Firebase 驗證身分才能執行的應用程式功能,請完成下列步驟,以匿名方式登入使用者:

FirebaseAuth 類別是所有 API 呼叫的閘道。 可透過 FirebaseAuth.DefaultInstance 存取。
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
1. 呼叫 Firebase.Auth.FirebaseAuth.SignInAnonymouslyAsync。
auth.SignInAnonymouslyAsync().ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInAnonymouslyAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInAnonymouslyAsync 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);
});

將匿名帳戶轉換為永久帳戶

當匿名使用者註冊應用程式時,您可能希望允許他們使用新帳戶繼續工作,例如,您可能希望讓使用者在註冊前加入購物車的商品,在新帳戶的購物車中也能使用。如要這樣做,請完成下列步驟:

  1. 使用者註冊時,請完成使用者驗證供應商的登入流程,但不要呼叫 Firebase.Auth.FirebaseAuth.SignInAndRetrieveDataWithCredentialAsync 方法。例如取得使用者的 Google ID 權杖、Facebook 存取權杖,或是電子郵件地址和密碼。
  2. 取得新驗證供應商的 Firebase.Auth.Credential:

  3. 將 Firebase.Auth.Credential 物件傳遞至登入使用者的 LinkWithCredentialAsync 方法:

如果對 LinkWithCredentialAsync 的呼叫成功,使用者的新帳戶就能存取匿名帳戶的 Firebase 資料。

自動清除

如果專案已升級至 Firebase Authentication with Identity Platform,您可以在 Firebase 控制台中啟用自動清除功能。啟用這項功能後,Firebase 就會自動刪除建立至今超過 30 天的匿名帳戶。在啟用自動清除功能的專案中,匿名驗證不會計入用量限制或計費配額。

  • 啟用自動清理功能後建立的匿名帳戶,可能會在建立 30 天後隨時遭到自動刪除。
  • 啟用自動清理功能後,現有的匿名帳戶會在 30 天後自動刪除。
  • 如果關閉自動清理功能,系統仍會刪除已排定要刪除的匿名帳戶。
  • 如果您「升級」匿名帳戶,將其連結至任何登入方式,系統就不會自動刪除該帳戶。

如要在啟用這項功能前,查看會受到影響的使用者人數,且已將專案升級至 Firebase Authentication with Identity Platform,您可以在 Cloud Logging 中依 is_anon 進行篩選。

後續步驟

使用者現在可以透過 Firebase 驗證身分,您可以使用 Firebase 規則,控管使用者對 Firebase 資料庫中資料的存取權。