設定 Google Play 遊戲服務

本文說明如何使用 Google Play 管理中心為 Android 遊戲設定 Google Play 遊戲服務。Google Play 管理中心可讓您集中管理遊戲服務，並設定中繼資料以授權及驗證遊戲。

如要將遊戲新增至 Google Play 管理中心，請按照下列一般步驟操作：

  • 為遊戲建立遊戲專案，並指定遊戲名稱和說明等詳細資訊。
  • 建立並連結必要憑證，以便授權和驗證遊戲使用 Google Play 遊戲服務。

以下各節將詳細介紹這些步驟。

步驟 1：登入 Google Play 管理中心

如要登入，請前往 Google Play 管理中心。如果你尚未註冊 Google Play 管理中心，系統將提示你進行註冊程序。

步驟 2：將您的遊戲加入 Google Play 管理中心

若要新增遊戲，請按照以下步驟操作：

  1. 在 Play 管理中心建立遊戲 (如果尚未建立的話)。詳情請參閱這裡。
  2. 前往 [拓展] > [Play 遊戲服務] > [設定與管理] > [設定]。

  3. 指定遊戲是否已使用 Google API (例如 Firebase)。 選擇正確選項非常重要。

    • 如果您要從頭開始建立遊戲，或從未設定過 Google API，請選擇 [否，我的遊戲沒有使用 Google API]。輸入遊戲名稱，然後按一下 [建立]。
    • 如果遊戲已設定一或多個 Google API，請選擇 [是，我的遊戲已採用 Google API]。Google Cloud Console 會列出您列為開發人員的專案清單。從清單中選取專案，然後按一下 [Use] (使用)。
    • 如要使用現有的 Play 遊戲服務專案，請選擇 [使用現有的 Play 遊戲服務專案]。系統會列出您帳戶的現有 Play 遊戲服務專案。從清單中選取正確的遊戲專案，然後按一下「Use」(使用)。這並不是一般的選擇，但如果您是透過 Play 管理中心建立新遊戲來變更套件名稱，或是遊戲的免費版和付費版具有不同套件名稱，就代表這麼做。

  4. 系統建立 Play 遊戲服務遊戲專案，並在 Google Cloud Console 中為您建立對應的項目。

  5. 在「Properties」(屬性) 部分，您可以選取「Edit Properties」(編輯屬性)，然後新增遊戲的說明、類別和圖像資源。

步驟 3：產生 OAuth 2.0 用戶端 ID

您的遊戲必須具備 OAuth 2.0 用戶端 ID，才能通過驗證並授權呼叫 Google Play 遊戲服務。如果想為 Play 遊戲服務設定憑證，當做用戶端 ID 和遊戲之間的關聯資源，請用 Google Cloud Platform 建立用戶端 ID。然後使用 Google Play 管理中心新增憑證，以便將用戶端 ID 連結到遊戲。

詳細操作說明請看以下步驟：

如果您尚未設定 OAuth 同意畫面，「Credentials」(憑證) 區段會顯示訊息並要求您進行設定。

設定 OAuth 同意畫面的系統要求

按一下「Configure」(設定)。這樣做會開啟對話方塊，其中會進一步說明步驟，並附上 Google Cloud Platform 的深層連結。

設定 OAuth 同意畫面。請前往 Google Cloud Platform 設定並發布 OAuth 同意畫面的設定頁面。1. 前往 Google Cloud Platform 的 OAuth 同意畫面設定頁面。2. 將同意畫面提供給 Google Play 上的所有人 (外部) 或僅供機構內部人員使用 (內部)。3. 提供應用程式名稱，此名稱必須與您在 Play 管理中心中的遊戲名稱相符。4. 新增範圍：games、games_lite 和 drive.appdata。5. 發布你的同意畫面。6. 返回 Play 管理中心確認設定。

完成 OAuth 同意畫面設定後，按一下「Done」(完成)。Google Play 管理中心會自動重新整理，如果設定成功，您就可以建立憑證了：

建立憑證

b. 建立憑證

為了授權您的遊戲與 Google Play 遊戲服務通訊，您必須使用獲授權的 OAuth2 用戶端 ID 建立憑證。

按一下「Credentials」(憑證) 區段內的「Add credential」(新增憑證)。

在精靈中，選擇您要建立 Android 憑證 (如果您的遊戲 APK 會驗證使用者並使用 PGS API) 或遊戲伺服器憑證 (如果您的遊戲伺服器會使用 PGS API)。請按照您所需憑證類型適用的操作說明進行。

Android

「設定憑證詳細資料」

確認「Name」(名稱) 欄位內的名稱和遊戲名稱相符。選擇是否要啟用反盜版功能。

「設定授權」

接下來，選取這個遊戲專案要用的 OAuth 用戶端 ID。如果您已經有 OAuth2 用戶端 ID，可以在此選擇。不過，我們通常會建立新的用戶端 ID。按一下「Create OAuth client」(建立 OAuth 用戶端)。這樣做會開啟對話方塊，其中會附上在 Google Cloud Platform 建立 OAuth 用戶端 ID 的深層連結和操作說明。

  1. 將應用程式類型設為「Android」。
  2. 在「Name」(名稱) 欄位輸入遊戲名稱。
  3. 在「Package name」(套件名稱) 欄位輸入 Android 應用程式的套件名稱。

  4. 開啟終端機並執行 Keytool 公用程式，以便取得版本和偵錯憑證的 SHA1 指紋。

    如果想取得版本的憑證指紋，請執行以下指令：

    keytool -list -keystore <path-to-production-keystore> -v

    如果想取得偵錯憑證指紋，請執行以下指令：

    keytool -list -keystore <path-to-debug-keystore> -v

  5. Keytool 公用程式會提示您輸入 Keystore 密碼。偵錯 KeyStore 的預設密碼為 android。然後，Keytool 會在終端機列印指紋。

  6. 把 SHA1 指紋貼到「Signing certificate fingerprint (SHA1)」(簽署憑證指紋 (SHA1)) 欄位內。

  7. 按一下「建立」。

如要進一步瞭解 Android 裝置上的 OAuth 2.0，請參閱「驗證 OAuth2 服務」。

按下對話方塊內的「Done」(完成) 之後，可用的用戶端 ID 就會重新整理。從下拉式選單中選取您建立的憑證，然後按一下「Save Changes」(儲存變更內容)。這樣做會將憑證儲存為草稿，讓您可以在遊戲內驗證 Play 遊戲服務。

建議您建立兩個憑證：一個憑證使用版本憑證指紋，令一個使用偵錯憑證指紋。確認兩個憑證都使用相同的套件名稱。這樣做可以讓 Google Play 遊戲服務辨識已連結並用其他憑證簽署的 APK 提出的呼叫。如果想進一步瞭解 Android 憑證簽署，請參閱「簽署應用程式」。

遊戲伺服器

「設定憑證詳細資料」

確認「Name」(名稱) 欄位內的名稱和遊戲名稱相符。

「設定授權」

接下來，選取這個遊戲專案要用的 OAuth 用戶端 ID。如果您已經有 OAuth2 用戶端 ID，可以在此選擇。不過，我們通常會建立新的用戶端 ID。按一下「Create OAuth client」(建立 OAuth 用戶端)。這樣做會開啟對話方塊，其中會附上在 Google Cloud Platform 建立 OAuth 用戶端 ID 的深層連結和操作說明。

  1. 將應用程式類型設為「Web application」(網頁應用程式)。
  2. 在「Name」(名稱) 欄位輸入遊戲名稱。
  3. 按一下「建立」。

如要進一步瞭解 Android 裝置上的 OAuth 2.0，請參閱「驗證 OAuth2 服務」。

按下對話方塊內的「Done」(完成) 之後，可用的用戶端 ID 就會重新整理。從下拉式選單中選取您建立的憑證，然後按一下「Save Changes」(儲存變更內容)。這樣做會將憑證儲存為草稿，讓您可以從遊戲伺服器驗證 Play 遊戲服務。如果想進一步瞭解如何透過遊戲伺服器使用 Play 遊戲服務，請參閱「啟用 Google Play 遊戲服務的伺服器端存取權」。

避免常見的設定問題

為了避免設定錯誤，在設定遊戲以使用 Google Play 遊戲服務時，請務必遵循這些建議。

1. 使用 Google Play 管理中心設定遊戲
如果您已在 Google Cloud Console 中為應用程式建立 OAuth 2.0 用戶端 ID，Google Play 遊戲服務就無法得知遊戲成就和排行榜與用戶端 ID 之間的關聯。若要建立關聯，您必須按照「建立憑證」的說明使用 Oauth 2.0 用戶端 ID 建立憑證。
2. 在 Android 使用正確的應用程式 ID
應用程式 ID 是必須提供的字串資源，您必須在 Android 資訊清單裡參照這個 ID。應用程式 ID 字串僅由 Google Play 管理中心提供的用戶端 ID 開頭的數字 (通常為 12 以上) 組成。應用程式 ID 位於「Configuration」(設定) 頁面頂端，位於您的遊戲名稱下方，並標記為「Project ID」(專案 ID)。
3. 使用正確憑證簽署 APK
在 Google Play 管理中心將 Android 應用程式連結至遊戲時，您必須使用與發布應用程式相同的套件名稱和憑證指紋。如果不符，系統會呼叫 Google Play 遊戲服務。您應該建立兩個用戶端 ID，一個使用版本憑證指紋，另一個使用偵錯憑證指紋，並讓兩個 ID 使用相同的套件名稱。如要進一步瞭解如何在 Google Play 管理中心指定簽署憑證，請參閱簽署應用程式。
4. 開發 Android 應用程式時，請將 Play 遊戲 SDK 新增為程式庫專案，而非做為獨立的 JAR
請確保 Google Play 服務 SDK 參照為 Android 專案中的程式庫專案，否則應用程式將無法找到 Google Play 服務資源。如要瞭解如何設定 Android 專案以使用 Google Play 服務，請參閱設定 Google Play 服務。
5. 在開發期間使用測試人員帳戶登入
如果您尚未在 Google Play 管理中心發布遊戲設定變更，如果您並未使用加入許可清單的測試人員帳戶登入，測試過程可能會發生錯誤。請一律啟用 Google Play 管理中心發布者帳戶進行測試。如果想瞭解如何管理測試人員帳戶，請參閱「啟用測試帳戶」。
6. 在 Google Cloud Platform 發布同意畫面
在 Google Play 管理中心發布應用程式之前，請先在 Google Cloud Platform 上發布同意畫面。如果您沒有進行此操作，其他大眾將無法使用任何 Play 遊戲服務功能。
7. 要釋出版本時，請先發布 Play 遊戲服務設定，然後再發布遊戲
開發人員可能會不小心發布應用程式，同時又未發布對應的 Google Play 遊戲服務設定。如果應用程式無法參照正確的遊戲設定，可能會導致玩家使用非測試人員帳戶登入。發布遊戲時，請記得先使用 Google Play 管理中心的 [發布遊戲] 選項發布遊戲設定。若要瞭解如何發布變更內容，請參閱「發布遊戲變更」。

如需其他提示，請參閱：

後續步驟

在繼續作業之前，請按照啟用帳戶測試的說明，在遊戲中新增測試帳戶。具有授權測試帳戶的使用者可以存取您未發布的 Play 遊戲服務遊戲專案，並測試您設定的 Google Play 遊戲服務是否正常運作。

完成上述的初始設定工作後，您就可以繼續設定遊戲功能，例如排行榜和成就。 詳情請參閱啟用功能。