設定 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. 依序前往「Grow」(拓展) >「Play Games Services」>「Setup and management」>「Configuration」。

3. 指定要使用的 Play 遊戲服務專案。您可以從頭開始建立專案，或選擇使用現有專案。

   • 建立新的 Play 遊戲服務專案：您必須先建立雲端專案，才能建立 Play 遊戲服務專案。

     • 如果您已為此遊戲建立雲端專案，請從下拉式清單中選取您的雲端專案，然後選取「Use」(使用)。

     • 否則，請選取「Create new Cloud project」(建立新的雲端專案)，然後按照操作說明為這個遊戲建立新的 Cloud 專案。接著選取「Refresh cloud projects」(重新整理雲端專案)，然後從下拉式清單中選取您新建立的 Cloud 專案，然後按一下 [Use] (使用)。

   • 使用現有的 Play 遊戲服務專案：如果您要在 Play 管理中心建立新遊戲來變更現有的套件名稱，或者您的遊戲有免費和付費版本使用不同的套件名稱，就可以使用這個選項。選擇 Play 遊戲服務專案，然後按一下「Use」(使用)。

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

5. 在「Properties」(屬性) 區段中，選取「Edit Properties」(編輯屬性)，然後新增遊戲的說明、類別及圖像資源。

   • 測試只需要使用顯示名稱。您必須填妥其他欄位，然後才能發布遊戲。
   • 遊戲的顯示名稱和說明應符合您為遊戲的 Play 商店資訊所設定的名稱和說明。
   • 如需建立圖像資源的指南，請參閱 Google Play 開發人員指南和 Google Play 精選圖片指南。

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

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

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

a. 設定 OAuth 同意畫面

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

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

注意： 請確保所有遊戲玩家都能看到同意畫面。最終範圍清單必須包含 games、games_lite 和 drive.appdata，這些範圍都不需要進行應用程式驗證。建議您立即發布同意畫面。如果您無法立即發布，可以對測試人員開放同意畫面，讓測試人員可以登入遊戲。

完成 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

   注意：Windows 的偵錯 KeyStore 位於 C:\Users\<USERNAME>\.android\debug.keystore。Mac 或 Linux 的偵錯 KeyStore 通常位於 ~/.android/debug.keystore。

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 控制台為應用程式建立 Oauth 2.0 用戶端 ID，那麼 Google Play 遊戲服務無法得知遊戲成就、排行榜及用戶端 ID 之間有關聯。若要建立關聯，您必須按照「建立憑證」的說明使用 Oauth 2.0 用戶端 ID 建立憑證。

2. 在 Android 使用正確的應用程式 ID

應用程式 ID 是必須提供的字串資源，您必須在 Android 資訊清單裡參照這個 ID。應用程式 ID 字串只使用數字 (通常為 12 個以上)，位於 Google Play 管理中心提供的用戶端 ID 開頭。您可以在「設定」頁面頂端找到應用程式 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 管理中心的「Publish Game」(發布遊戲) 選項發布遊戲設定。若要瞭解如何發布變更內容，請參閱「發布遊戲變更」。

如需其他訣竅，請參閱：

• Android 疑難排解指南：開發人員說明文件，說明如何排解 Android 遊戲開發過程中的問題。

後續步驟

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

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