開始使用 Android 遊戲服務

歡迎使用 Google Play 遊戲服務，享受 Android 遊戲開發！

Play 遊戲 SDK 提供跨平台的 Google Play 遊戲服務，可讓您在平板電腦和手遊中輕鬆整合熱門的遊戲功能，例如成就、排行榜和遊戲進度存檔。

此訓練將引導您安裝 Android 範例遊戲應用程式，並快速開始建立自己的 Android 遊戲。Type-a-Number Challenge 範例應用程式示範瞭如何將遊戲和排行榜整合到遊戲中。

事前準備

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

應用程式必要條件

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

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

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

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

設定應用程式

在專案層級的 build.gradle 檔案中，在 buildscript 和 allprojects 區段中加入 Google Maven 存放區和 Maven Central 存放區：

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

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

將 Play 遊戲 SDK 的 Google Play 服務依附元件新增至模組的 Gradle 版本檔案，通常為 app/build.gradle：

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

範例應用程式指南

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

這份開發人員指南需要下載 Type-a-Number Challenge Android 應用程式。

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

從範例下載頁面下載 Android 範例。
匯入 android-basic-samples 專案。這項專案包含 TypeANumber 和其他 Android 遊戲範例。如何在 Android Studio 中執行此操作：
1. 依序點選 [File] (檔案) > [Import Project] (匯入專案)。
2. 前往開發機器下載 android-basic-samples 的目錄。選取所需檔案 android-basic-samples/build.gradle，然後按一下 [OK] (確定)。
在 TypeANumber 模組中開啟 AndroidManifest.xml，並將套件名稱從 com.google.example.games.tanc 變更為您自己的其他套件名稱。新的套件名稱開頭不得為 com.google、com.example 或 com.android。

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

您可以在 Google Play 管理中心管理遊戲的 Google Play 遊戲服務，並設定中繼資料來授權及驗證遊戲。

如何在 Google Play 管理中心設定遊戲範例：

將網路瀏覽器指向 Google Play 管理中心並登入帳戶。如果你尚未註冊 Google Play 管理中心，系統將提示你進行註冊程序。
按照這些操作說明，將您的遊戲新增至 Google Play 管理中心。
1. 當系統詢問您是否在應用程式中使用 Google API 時，請選取 [我尚未在遊戲中使用任何 Google API]。
2. 如本開發人員指南所述，您可以在表單中填入自己的遊戲詳細資料。為了方便起見，您可以使用「Downloads」(下載) 頁面中提供的預留位置圖示和螢幕截圖。
按照這些說明為您的 Android 應用程式產生 OAuth 2.0 用戶端 ID。
1. 連結 Android 應用程式時，請務必指定您在重新命名範例套件時使用的是的確切套件名稱。
2. 如果您還沒有 Android Key 精靈和已簽署的憑證，可以使用 Android Studio 中的「產生已簽署的 APK 精靈」來產生憑證。如要瞭解如何執行「產生已簽署的 APK」精靈，請參閱在 Android Studio 中簽署應用程式。
請務必記錄以下資訊，以供日後使用：
1. 您的「應用程式 ID」：這是包含數字 (通常為 12 以上) 的字串，且位於用戶端 ID 的開頭。
2. 您的簽署憑證：記下您設定 API 存取權時使用的憑證，也就是您提供的 SHA1 指紋憑證。測試或發布應用程式時，您應使用相同的憑證簽署應用程式。

設定 Type-a-Number Challenge 的成就：

選取 Google Play 管理中心的「成就」分頁。

新增下列範例成就：

名稱	說明	特殊指示
基本風	取得分數後得到的分數。	無
Humble	要求分數為 0。	無
不要抓到嬰兒	無論使用哪一種模式，都能要求 9999 分。	無
太棒了，U TEH UBER ！	得到 1337 分。	將此動作設為隱藏的成就。
無聊	玩遊戲 10 次。	解鎖 10 個步驟即可解鎖，逐步提升成就。
其實無聊	遊玩 100 次。	解鎖 100 步即可解鎖更多成就。

記錄您建立的每個成就 ID (長英數字元字串)。
設定您遊戲適用的成就。詳情請參閱成就的概念和如何在 Android 中實作成就。

設定「類比數字挑戰」的排行榜：
1. 在 Google Play 管理中心選取 [排行榜] 標籤。
2. 新增兩個排行榜：一個是「簡單高分」，一個是「高分數」，兩個排行榜都應使用整數分數格式，以小數點後 0 位表示，且排序類型為 [更大的] 較佳。
3. 記錄您建立的每個排行榜的 ID (由英數字元組成的字串)。
4. 設定您遊戲適用的排行榜。詳情請參閱排行榜背後的概念和如何在 Android 中實作排行榜。
新增遊戲的測試帳戶。只有在 Google Play 管理中心尚未發布的應用程式才需要執行這個步驟。在應用程式發布之前，只有 Google Play 管理中心列出的測試帳戶才能登入。但在應用程式發布之後，所有人都能登入。

步驟 3：修改程式碼

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

開啟 res/values/ids.xml 並取代預留位置 ID。如果您是從頭開始建立 Android 遊戲，則必須先建立這個檔案。
1. 在 app_id 資源中指定您的應用程式 ID。
2. 指定您先前在對應的 achievement_* 資源中建立的每個成就 ID。
3. 指定您先前在對應的 leaderboard_* 資源中建立的排行榜 ID。

開啟 AndroidManifest.xml，然後在 <manifest> 元素的 package 屬性中輸入套件名稱。如果您要從頭建立 Android 遊戲，也請務必在 <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 遊戲服務可正常用於遊戲，請先在 Google Play 上發布應用程式，再進行測試。

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

確認您已設定用來登入應用程式的測試帳戶 (如步驟 2 所述)。
匯出 APK 並使用您在 Google Play 管理中心設定專案時所用的憑證簽署該 APK。如要在 Android Studio 中匯出已簽署的 APK，請依序按一下 [建立] > [產生已簽署的 APK]。
使用 adb 工具在實體測試裝置上安裝已簽署的 APK。如要瞭解如何安裝應用程式，請參閱在裝置上執行。