使用 GitHub 和 Unity 進行驗證

您可將 GitHub 驗證整合至您的應用程式，讓使用者使用 GitHub 帳戶向 Firebase 進行驗證。

事前準備

使用 Firebase 驗證前，您必須先完成以下事項：

  • 註冊 Unity 專案，並將其設定為使用 Firebase。

    • 如果您的 Unity 專案已使用 Firebase，表示該專案已完成註冊並設定 Firebase。

    • 如果您沒有 Unity 專案，可以下載範例應用程式。

  • 在 Unity 專案中新增 Firebase Unity SDK (尤其是 FirebaseAuth.unitypackage)。

請注意，將 Firebase 新增至 Unity 專案涉及到 Firebase 主控台和開放式 Unity 專案中的工作 (例如從主控台下載 Firebase 設定檔，再移至 Unity 專案)。

存取 Firebase.Auth 類別

FirebaseAuth 類別是所有 API 呼叫的閘道，您可透過 FirebaseAuth.DefaultInstance 存取。
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

透過 Firebase 驗證

  1. 按照 Android 和 iOS+ 的操作說明，取得登入 GitHub 使用者的權杖。
  2. 使用者成功登入後，交換 Firebase 憑證的存取權杖，並使用 Firebase 憑證透過 Firebase 進行驗證：
    Firebase.Auth.Credential credential =
    Firebase.Auth.GitHubAuthProvider.GetCredential(accessToken);
auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync 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);
});

後續步驟

使用者首次登入時，系統會建立新的使用者帳戶，並連結至憑證 (即使用者名稱與密碼、電話號碼或驗證提供者資訊)，也就是使用者登入時使用的憑證。這個新帳戶會儲存在您的 Firebase 專案中，可用來識別專案中各個應用程式的使用者 (無論使用者登入方式為何)。

  • 在應用程式中，您可以透過 Firebase.Auth.FirebaseUser 物件取得使用者的基本個人資料：

    Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  string name = user.DisplayName;
  string email = user.Email;
  System.Uri photo_url = user.PhotoUrl;
  // The user's Id, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server, if you
  // have one; use User.TokenAsync() instead.
  string uid = user.UserId;
}

  • 在 Firebase 即時資料庫和 Cloud Storage 安全性規則中，您可以透過 auth 變數取得登入使用者的專屬 ID，並使用該 ID 控管使用者可存取哪些資料。

您可以將驗證供應商憑證連結至現有的使用者帳戶，讓使用者透過多個驗證服務提供者登入您的應用程式。

如要登出使用者，請呼叫 SignOut()：

auth.SignOut();