您可以使用 Google Play 遊戲服務，讓玩家登入在 Firebase 上打造的 Android 遊戲。如要透過 Firebase 使用 Google Play 遊戲服務登入功能，請先使用 Google Play 遊戲登入玩家，然後再要求 OAuth 2.0 驗證碼。接著，將驗證碼傳遞至 PlayGamesAuthProvider 以產生 Firebase 憑證，供您透過 Firebase 進行驗證。
事前準備
設定 Android 專案
如果您尚未將 Firebase 新增至 Android 專案，請先完成這項作業。
在模組 (應用程式層級) Gradle 檔案 (通常是
<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle) 中，新增 Android 專用 Firebase 驗證程式庫的依附元件。建議您使用 Firebase Android BoM 控管程式庫的版本管理。此外，設定 Firebase 驗證時，您必須將 Google Play 服務 SDK 新增至您的應用程式。
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.0.0")) // Add the dependency for the Firebase Authentication library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-auth")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:21.1.1") }只要使用 Firebase Android BoM，您的應用程式就會一律使用相容的 Firebase Android 程式庫版本。
(替代做法) 新增 Firebase 程式庫依附元件，「不」使用 BoM
如果選擇不使用 Firebase BoM，就必須在依附元件行中指定每個 Firebase 程式庫版本。
請注意，如果您在應用程式中使用多個 Firebase 程式庫，強烈建議您使用 BoM 來管理程式庫版本，以確保所有版本都相容。
dependencies { // Add the dependency for the Firebase Authentication library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-auth:23.0.0")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:21.1.1") }
設定 Firebase 專案
前往 Firebase 控制台的「Settings」(設定) 頁面，設定遊戲的 SHA-1 指紋。
您可以使用 Gradle
signingReport指令取得簽署憑證的 SHA 雜湊：./gradlew signingReport
啟用 Google Play 遊戲做為登入提供者：
找出專案的網路伺服器用戶端 ID 和用戶端密鑰。網路伺服器用戶端 ID 會向 Google Play 驗證伺服器識別您的 Firebase 專案。
如何找出這些值：
接著，在 Firebase 控制台開啟「驗證」專區。
在「Sign in method」分頁中，啟用「Play Games」登入提供者。您必須指定從 API 控制台取得的專案網路伺服器用戶端 ID 和用戶端密鑰。
使用 Firebase 應用程式資訊設定 Play 遊戲服務
在 Google Play 管理中心開啟您的 Google Play 應用程式或建立一個應用程式。
在「Grow」部分中，依序按一下「Play Games services」>「Setup & Management」>「Configuration」。
按一下「是，我的遊戲已在使用 Google API」，從清單中選取您的 Firebase 專案，然後按一下「使用」。
在 Play 遊戲服務設定頁面上，按一下「新增憑證」。
- 選取「遊戲伺服器」類型。
- 在「OAuth 用戶端」欄位中，選取專案的網路用戶端 ID。請確認這組用戶端 ID 與您啟用 Play 遊戲登入功能時指定的用戶端 ID 相同。
- 儲存變更。
同樣在 Play 遊戲服務設定頁面，再按一下「Add Credential」。
- 選取「Android」類型。
- 在「OAuth client」(OAuth 用戶端) 欄位中，選取專案的 Android 用戶端 ID。(如果沒有看到您的 Android 用戶端 ID，請務必在 Firebase 控制台中設定遊戲的 SHA-1 指紋)。
- 儲存變更。
在「測試人員」頁面上，為需要能夠登入遊戲的使用者，在 Play 商店發布遊戲前，新增他們的電子郵件地址。
將 Play 遊戲登入程序整合至遊戲
首先，請將 Play 遊戲登入功能整合至您的應用程式。如需完整操作說明，請參閱「登入 Android 遊戲」。
在整合功能中建構 GoogleSignInOptions 物件時，請使用 DEFAULT_GAMES_SIGN_IN 設定並呼叫 requestServerAuthCode：
Kotlin+KTX
val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
.requestServerAuthCode(getString(R.string.default_web_client_id))
.build()
Java
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
.requestServerAuthCode(getString(R.string.default_web_client_id))
.build();
您必須將網路伺服器用戶端 ID 傳遞至 requestServerAuthCode 方法。這是您在 Firebase 控制台啟用 Play 遊戲登入功能時提供的 ID。
透過 Firebase 驗證
在應用程式中新增 Play 遊戲登入功能後，您必須設定 Firebase，以便使用玩家成功登入 Play 遊戲後取得的 Google 帳戶憑證。
- 首先，在登入活動的
onCreate方法中，取得FirebaseAuth物件的共用例項：
Kotlin+KTX
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
- 初始化活動時，請檢查玩家是否已透過 Firebase 登入：
Kotlin+KTX
override fun onStart() {
super.onStart()
// Check if user is signed in (non-null) and update UI accordingly.
val currentUser = auth.currentUser
updateUI(currentUser)
}
Java
@Override
public void onStart() {
super.onStart();
// Check if user is signed in (non-null) and update UI accordingly.
FirebaseUser currentUser = mAuth.getCurrentUser();
updateUI(currentUser);
}
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
- 玩家以無訊息或互動方式登入 Play 遊戲後，請從
GoogleSignInAccount物件取得驗證碼，換取 Firebase 憑證，然後使用 Firebase 憑證透過 Firebase 進行驗證：
Kotlin+KTX
// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private fun firebaseAuthWithPlayGames(acct: GoogleSignInAccount) {
Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.id!!)
val auth = Firebase.auth
val credential = PlayGamesAuthProvider.getCredential(acct.serverAuthCode!!)
auth.signInWithCredential(credential)
.addOnCompleteListener(this) { task ->
if (task.isSuccessful) {
// Sign in success, update UI with the signed-in user's information
Log.d(TAG, "signInWithCredential:success")
val user = auth.currentUser
updateUI(user)
} else {
// If sign in fails, display a message to the user.
Log.w(TAG, "signInWithCredential:failure", task.exception)
Toast.makeText(
baseContext,
"Authentication failed.",
Toast.LENGTH_SHORT,
).show()
updateUI(null)
}
// ...
}
}
Java
// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private void firebaseAuthWithPlayGames(GoogleSignInAccount acct) {
Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.getId());
final FirebaseAuth auth = FirebaseAuth.getInstance();
AuthCredential credential = PlayGamesAuthProvider.getCredential(acct.getServerAuthCode());
auth.signInWithCredential(credential)
.addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
@Override
public void onComplete(@NonNull Task<AuthResult> task) {
if (task.isSuccessful()) {
// Sign in success, update UI with the signed-in user's information
Log.d(TAG, "signInWithCredential:success");
FirebaseUser user = auth.getCurrentUser();
updateUI(user);
} else {
// If sign in fails, display a message to the user.
Log.w(TAG, "signInWithCredential:failure", task.getException());
Toast.makeText(MainActivity.this, "Authentication failed.",
Toast.LENGTH_SHORT).show();
updateUI(null);
}
// ...
}
});
}
如果呼叫 signInWithCredential 成功，您可以使用 getCurrentUser 方法取得使用者的帳戶資料。
後續步驟
使用者首次登入後，系統會建立新的使用者帳戶，並連結至他們的 Play 遊戲 ID。這個新帳戶會儲存為 Firebase 專案的一部分，可用來在專案中的每個應用程式中識別使用者。
在遊戲中，您可以從 FirebaseUser 物件取得使用者的 Firebase UID：
Kotlin+KTX
val user = auth.currentUser
user?.let {
val playerName = it.displayName
// 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 FirebaseUser.getIdToken() instead.
val uid = it.uid
}
Java
FirebaseUser user = mAuth.getCurrentUser(); String playerName = user.getDisplayName(); // 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 FirebaseUser.getIdToken() instead. String uid = user.getUid();
在 Firebase 即時資料庫和 Cloud Storage 安全性規則中，您可以透過 auth 變數取得登入使用者的專屬 ID，並使用該 ID 控制使用者可以存取哪些資料。
如要取得使用者的 Play 遊戲玩家資訊，或存取 Play 遊戲服務，請使用 Google Play 遊戲 SDK 提供的 API。
如要將使用者登出，請呼叫 FirebaseAuth.signOut()：
Kotlin+KTX
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();