開始使用 Android 專用 Play 遊戲服務

歡迎使用 Google Play 遊戲服務開發 Android 遊戲!

Play 遊戲 SDK 提供跨平台的 Google Play 遊戲服務, 整合熱門遊戲功能,例如成就、排行榜 平板電腦和手機遊戲中的「遊戲進度存檔」。

本訓練課程將指導您安裝 Android 遊戲應用程式範例 就能立即開始製作自己的 Android 遊戲。Type-a-Number 挑戰範例應用程式示範如何將成就整合 在遊戲中納入排行榜。

事前準備

如要讓應用程式做好準備,請完成下列各節的步驟。

應用程式必要條件

請確認應用程式的版本檔案使用下列的值:

  • minSdkVersion 19 以上版本
  • compileSdkVersion 28 以上版本

前往 Google Play 管理中心設定您的遊戲

您可以使用 Google Play 管理中心管理遊戲的 Google Play 遊戲服務,並且設定授權和驗證遊戲所需的中繼資料。詳情請參閱「設定 Google Play 遊戲服務」。

設定應用程式

在專案層級的 build.gradle 檔案中納入 Google 的 Maven 存放區Maven 中央存放區 請在 buildscriptallprojects 區段中:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

將 Play Games SDK 的 Google Play 服務依附元件加入 「模組的 Gradle 建構檔案」,這通常會造成 app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

範例應用程式指南

本訓練課程將引導您安裝 Android 適用的範例遊戲應用程式 就能立即開始製作自己的 Android 遊戲。Type-a-Number 挑戰範例應用程式示範如何將成就整合 在遊戲中納入排行榜。

步驟 1:下載範例應用程式

在此開發人員指南中,您將需要下載 Type-a-Number Challenge 範例 Android 應用程式。

如要在 Android Studio 中下載並設定範例應用程式:

  1. 下載 Android 範例 範例下載頁
  2. 匯入 android-basic-samples 專案。這項專案包含「TypeANumber」和其他 Android 遊戲 樣本。如要在 Android Studio 中執行此操作:
    1. 按一下「檔案」>匯入專案
    2. 前往您在開發作業中下載 android-basic-samples 的目錄 這類機制更為快速選取 android-basic-samples/build.gradle 檔案,然後按一下「OK」
  3. TypeANumber 模組中開啟 AndroidManifest.xml,並將套件名稱從 com.google.example.games.tanc 是您其他套件名稱。新的套件名稱必須 開頭不得為 com.googlecom.examplecom.android

步驟 2:在 Google Play 管理中心設定遊戲

Google Play 管理中心可讓您管理遊戲的 Google Play 遊戲服務。 設定授權和驗證遊戲的中繼資料。

如要在 Google Play 管理中心設定範例遊戲,請按照下列步驟操作:

  1. 將網路瀏覽器指向 Google Play 管理中心 登入帳戶。如果尚未註冊 Google Play 管理中心,系統將提示您進行註冊程序。
  2. 請按照這些說明 將遊戲加入 Google Play 管理中心
    1. 當系統詢問您是否在應用程式中使用 Google API 時,請選取 [尚未在遊戲中使用任何 Google API]。
    2. 以這份開發人員指南為例,您可以填寫自己的表單 遊戲詳細資料。為方便起見,您可以使用預留位置圖示和螢幕截圖 用「下載」頁面提供的預留位置頁面。
  3. 請按照這些說明 產生 OAuth 2.0 用戶端 ID 您的 Android 應用程式。
    1. 連結 Android 應用程式時,請務必指定確切套件 您重新命名範例套件時使用的名稱。
    2. 您可以使用 Android Studio 中的「Generate Signed APK Wizard」(產生已簽署 APK 精靈) 來 如果您沒有金鑰庫和經過簽署的憑證,請產生新的 KeyStore 和簽署憑證。如要瞭解 執行 Generate Signed APK 精靈,前往 在 Android Studio 中簽署應用程式
  4. 請務必記錄以下資訊供日後使用:
    1. 您的應用程式 ID:這是字串 由數字組成 (通常有 12 個以上),位於您的用戶端 ID 開頭。
    2. 您的簽署憑證:記下您在設定時使用的憑證 您的 API 存取權 (您提供 SHA1 指紋的憑證)。個人中心 在測試或發布應用程式時,您必須使用相同的憑證簽署應用程式 應用程式。
  5. 設定 Type-a-Number Challenge 的成就:
    1. 在 Google Play 管理中心選取「成就」分頁標籤。
    2. 新增下列範例成就:
      名稱 說明 特殊指示
      角分符號 取得質數為質數的分數。
      Humble 要求的分數為 0。
      不要讓孩子相信 在兩種模式中要求分數為 9999。
      天啊! 獲得 1337 分。 將此設定為隱藏成就。
      無聊 遊玩遊戲 10 次。 將此設為需要完成 10 個步驟才能解鎖的漸進式成就。
      非常無聊 遊玩遊戲 100 次。 將此設為需要完成 100 個步驟才能解鎖的漸進式成就。
    3. 記錄您達成的每個成就的 ID (由英數字元組成字串) 已建立。
    4. 設定您遊戲適用的成就。如要瞭解詳情 成就的基本概念 以及如何在 Android 中實作成就
  6. 設定 Type-a-Number Challenge 的排行榜:
    1. 在 Google Play 管理中心選取「排行榜」分頁標籤。
    2. 新增兩個範例排行榜,分別命名為「Easy High Scores」與 名為「Hard High Scores」。這兩個排行榜都應使用整數分數格式 (小數點位數為 0),而且排序類型為 Larger is more
    3. 記錄您建立的每個排行榜的 ID (長英數字元字串)。
    4. 設定您遊戲適用的排行榜。如要瞭解詳情 排行榜的概念和 「在 Android 中實作排行榜」的方法。
  7. 新增遊戲的測試帳戶。 如果尚未發布的應用程式,才需要執行這個步驟。 Google Play 管理中心。在應用程式發布前,只有畫面上列出的測試帳戶 登入 Google Play 管理中心應用程式發布後 所有人都可登入。
,瞭解如何調查及移除這項存取權。

步驟 3:修改程式碼

如要執行遊戲,您必須將應用程式 ID 設為 Android 專案。此外,您也必須在 AndroidManifest.xml 中新增遊戲中繼資料。

  1. 開啟 res/values/ids.xml 並取代預留位置 ID。如果您是 從頭開始建立 Android 遊戲,則需要先建立這個檔案。
    1. app_id 資源中指定應用程式 ID。
    2. 在對應的 achievement_* 項資源。
    3. 在對應的 leaderboard_* 項資源。
  2. 開啟 AndroidManifest.xml 並在 package 中輸入套件名稱 <manifest> 的屬性元素。如果您要透過 請務必在 <application> 內加入下列程式碼元素:
    <meta-data android:name="com.google.android.gms.games.APP_ID"
        android:value="@string/app_id" />
    <meta-data android:name="com.google.android.gms.version"
       android:value="@integer/google_play_services_version"/>
    

步驟 4:測試遊戲

為確保 Google Play 遊戲服務可在遊戲中正常運作,請測試 。

如何在實體測試裝置上執行遊戲:

  1. 確認您已設定用來登入的測試帳戶 (如步驟 2 所述)。
  2. 匯出 APK 並使用您先前設定的憑證簽署 APK 。如要在 Android Studio 中匯出已簽署的 APK,請按一下 「Build」> >產生已簽署的 APK
  3. 使用 adb 工具在實體測試裝置上安裝已簽署的 APK。 如要瞭解如何安裝應用程式,請參閱 在裝置上執行
,瞭解如何調查及移除這項存取權。