設定 Google Play 遊戲服務

本頁面將說明如何使用 Google Play 管理中心為 Android 遊戲設定 Google Play 遊戲服務。您可以透過 Play 管理中心集中管理遊戲服務,並設定用來授權及驗證遊戲的中繼資料。

若要把遊戲加入 Play 管理中心,請按照以下一般步驟操作:

  • 為遊戲建立遊戲專案,並提供遊戲名稱、說明等詳細資料。

  • 建立並連結必要憑證,以便授權和驗證遊戲使用 Google Play 遊戲服務。

事前準備

登入 Play 管理中心

若要登入,請至 Google Play 管理中心。如果尚未註冊 Play 管理中心,系統將提示您進行註冊程序。

將遊戲加入 Play 管理中心

若要新增遊戲,請按照以下步驟操作:

  1. 在 Play 管理中心建立應用程式,然後說明這是遊戲。詳情請參閱「建立及設定應用程式」。

  2. 前往「Grow」(拓展) >「Play Games Services」(Play 遊戲服務) >「Setup and management」(設定與管理) >「Configuration」(設定)

  3. 說明遊戲是否已在使用 Google API (如 Firebase)。請務必選擇正確選項,否則遊戲使用 Google API 時可能會發生錯誤。選項如下:

    • 「No, my game doesn't use Google APIs」(否,我的遊戲沒有使用 Google API):如果您要建立新遊戲,或是從來沒為這個設定設定 Google API,請選擇這個選項。輸入遊戲名稱,然後按一下「Create」(建立)

    • 「Yes, my game already uses Google APIs」(是,我的遊戲使用了 Google API):如果您已有為遊戲設定 Google API,請選擇這個向。在這個情況下,您可以看到顯示您的 Google Cloud 控制台專案的清單。從清單中選取專案,然後按一下「Use」(使用)

    • 「Use an existing Play Games Services project」(使用現有的 Play 遊戲服務專案):如果您想使用現有的 Play 遊戲服務專案,請用這個選項。您會看到顯示帳戶現有 Play 遊戲服務專案的清單。從清單中選取您的遊戲專案,然後按一下「Use」(使用)。這不是常用的選項,但是如果您要在 Play 管理中心建立新遊戲,以便更改套件名稱,或是您的遊戲有免費和付費版本,並需要使用不同套件名稱,就可以選擇這個選項。

    系統會建立 Play 遊戲服務遊戲專案,並會在 Google Cloud 控制台建立相應的項目。

  4. 按一下「Properties」(屬性) 區段內的「Edit Properties」(編輯屬性) 並新增資訊,如遊戲的說明、類別及圖像資源。以下是這些屬性的設定指南:

產生 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 同意畫面的系統要求。

確定能夠遊玩遊戲的所有人都能看到同意畫面。最終範圍清單需包括 gamesgames_lite,和 drive.appdata,這些範圍都不需要進行應用程式驗證。建議您立即發布同意畫面。如果您無法立即發布,可以對測試人員開放同意畫面,讓測試人員可以登入遊戲。

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

建立憑證

建立憑證

為了授權遊戲和 Google Play 遊戲服務通訊,您必須使用經過授權的 OAuth2 用戶端 ID 建立憑證。

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

在精靈內選擇是否要建立 Android 憑證 (如果您的遊戲 APK 會驗證使用者並使用 Play 遊戲服務 API) 或遊戲伺服器憑證 (如果您的遊戲伺服器會使用 Play 遊戲服務 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. 按一下「Create」(建立)。

如要進一步瞭解 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. 按一下「Create」(建立)。

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

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

啟用測試

為了確定 Google Play 遊戲服務可以正確在遊戲裡發揮功能,您應在發布遊戲變更內容到 Google Play 之前測試遊戲服務。

如果您的遊戲狀態為尚未發布,請在許可清單中加入測試人員的使用者帳戶,藉此授予測試人員存取權。否則,當測試人員嘗試存取 Play 遊戲服務端點 (如登入端點) 時,將會發生 OAuth 和 404 錯誤。

持有授權測試帳戶的使用者可以存取您尚未發布的 Play 遊戲服務遊戲專案,並可以測試您設定的 Play 遊戲服務是否可以正常使用。

您可以透過以下兩種方式讓測試人員在您的遊戲裡使用 Play 遊戲服務 API:

  • 若是個人,您可以新增每個人的電子郵件地址。

  • 若是團體,您可以為 Play 管理中心的測試群組啟用 Play 遊戲服務。

若要在遊戲專案裡新增個別測試人員:

  1. 前往 Google Play 管理中心並開啟遊戲的「Tester」(測試人員) 分頁標籤 (「Grow」(拓展) >「Play Games Services」(Play 遊戲服務) >「Setup and management」(設定與管理) >「Testers」(測試人員))。
  2. 按一下「Add testers」(新增測試人員) 按鈕
  3. 在系統顯示的對話方塊中輸入您想設為測試人員的 Google 帳戶電子郵件地址 (以半形逗號隔開,或每行輸入一個電子郵件地址)。
  4. 按一下「Add」(新增) 將該名使用者設為測試人員。幾個小時候,新增的測試人員帳戶應該就能存取 Play 遊戲服務了。

若要授予群組測試存取權,請讓測試群組可以存取 Play 遊戲服務:

利用 Google Play 的測試群組功能,即可輕鬆將應用程式的預先發布版本發布給由您信任的使用者組成的控管群組。請參閱 Google Play 說明網站的「設定公開測試、封閉測試或內部測試」。

您可以授予存取權給某測試群組中所有能存取測試 APK 的使用者,以便測試您的遊戲。這和您個別把人員加入測試人員清單的情形相同。如要採用這種方式,請按照下列步驟進行:

  1. 開啟「PGS Testers」(PGS 測試人員) 區段 (「Grow」(拓展) >「Play Games Services」(Play 遊戲服務) >「Setup and management」(設定與管理) >「Testers」(測試人員)),然後點選「Release tracks」(測試群組) 分頁標籤。此頁面也會顯示已經可以測試 Play 遊戲服務的測試群組。
  2. 按一下「Add tracks」(新增測試群組)
  3. 選取一或多個測試群組,以便啟用 Play 遊戲服務測試功能。
  4. 按一下「Add Tracks」(新增測試群組)

可以測試 Play 遊戲服務的測試群組清單上便會顯示您選取的測試群組。

您的 Google Play 管理中心內的遊戲必須要有連結的 Android 應用程式,才能使用此功能。

避免常見問題

為了避免發生常見的設定問題,請在設定遊戲使用 Google Play 遊戲服務時遵守以下推薦事項。

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

其他秘訣請參閱 Android 疑難排解指南

後續步驟

按照上述說明完成初期設定作業後,您可以為遊戲啟用 Play 遊戲服務功能,如遊戲進度存檔、排行榜、成就等。