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

注意： 本指南適用於使用 Play 遊戲服務第 1 版 SDK。如需最新版 SDK 的資訊，請參閱 Play 遊戲服務第 2 版說明文件。

歡迎使用 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 檔案中，請同時在 buildscript 和 allprojects 區段中納入 Google Maven 存放區和 Maven 中央存放區：

  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'
  }

範例應用程式指南

本訓練課程會引導您安裝 Android 範例遊戲應用程式，並快速開始建立自己的 Android 遊戲。Type-a-Number 挑戰範例應用程式示範如何在遊戲中整合成就和排行榜。

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

針對這份開發人員指南，您必須下載 Type-a-Number Challenge Android 應用程式範例。

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

1. 從範例下載頁面下載 Android 範例。
2. 匯入 android-basic-samples 專案。這項專案包含 TypeANumber 和其他 Android 遊戲範例。如要在 Android Studio 中執行這項操作：
   1. 依序點選「File」 >「Import Project」。
   2. 前往您在開發機器上下載 android-basic-samples 的目錄。選取 android-basic-samples/build.gradle 檔案，然後按一下「OK」。
3. 在 TypeANumber 模組中開啟 AndroidManifest.xml，然後將套件名稱從 com.google.example.games.tanc 變更為您專屬的其他套件名稱。新的套件名稱不得以 com.google、com.example 或 com.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. 請按照下列操作說明，為您的 Android 應用程式產生 OAuth 2.0 用戶端 ID。
   1. 連結 Android 應用程式時，請務必指定您先前重新命名範例套件時使用的套件名稱。
   2. 如果您尚未建立新的 KeyStore 和經過簽署的憑證，可以使用 Android Studio 中的「Generate Signed APK」精靈來產生新的 KeyStore 和經過簽署的憑證。如要瞭解如何執行 Generate Signed APK 精靈，請參閱「在 Android Studio 中簽署應用程式」。
4. 請務必記下下列資訊供稍後使用：
   1. 您的應用程式 ID：這是用戶端 ID 開頭僅包含數字 (通常有 12 個以上) 的字串。
   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 isBetter」。
   3. 記錄您建立的各個排行榜的 ID (長英數字元字串)。
   4. 設定您遊戲適用的排行榜。詳情請參閱排行榜的概念和如何在 Android 中實作排行榜。
7. 新增遊戲的測試帳戶。只有尚未在 Google Play 管理中心發布的應用程式才需要執行這個步驟。發布應用程式之前，只有 Google Play 管理中心中列出的測試帳戶才能登入。但是，應用程式發布後，每個人都可以登入。

警告： 如果您嘗試使用未列為測試帳戶的帳戶來呼叫 Play 遊戲 SDK，用來呼叫尚未發布的遊戲，Google Play 遊戲服務會假設該遊戲並不存在，而您會收到 ConnectionResult.SIGN_IN_REQUIRED 傳回代碼。如果您嘗試啟動 ConnectionResult.startResolutionForResult()，將返回 GamesActivityResultCodes.RESULT_SIGN_IN_FAILED。

步驟 3：修改程式碼

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

1. 開啟 res/values/ids.xml 並取代預留位置 ID。如要從頭開始建立 Android 遊戲，您必須先建立這個檔案。
   1. 在 app_id 資源中指定應用程式 ID。
   2. 在對應的 achievement_* 資源中指定您先前建立的每個成就 ID。
   3. 在對應的 leaderboard_* 資源中指定您先前建立的每個排行榜 ID。
2. 開啟 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 發布應用程式前進行測試。

注意： 建議您使用實體 Android 裝置進行測試。但是，如果您沒有實體裝置，可使用 Android Emulator 進行測試。如要這麼做，請從 SDK Manager 下載包含 Google Play 服務的模擬器系統映像檔，位於 Android 4.2.2 下方。

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

1. 確認您已設定用來登入應用程式的測試帳戶 (如步驟 2 所述)。
2. 匯出 APK 並使用您在 Google Play 管理中心設定專案時所用的憑證簽署 APK。如要在 Android Studio 中匯出已簽署的 APK，請依序點選「Build」 >「Generate Signed APK」。
3. 使用 adb 工具在實體測試裝置上安裝已簽署的 APK。如要瞭解如何安裝應用程式，請參閱在裝置上執行。

警告： 直接從 Android Studio 執行應用程式時，Android Studio 預設會使用您的偵錯憑證簽署應用程式。如果您在 Google Play 管理中心設定應用程式時，並未使用這個偵錯憑證，就會發生錯誤。請務必使用您在 Google Play 管理中心設定應用程式設定時使用的憑證，用來執行您匯出及簽署的 APK。