歡迎使用 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.2.0'
}
範例應用程式指南
本訓練課程會引導您安裝 Android 遊戲範例應用程式,並快速開始建立自己的 Android 遊戲。Type-a-Number 驗證範例應用程式示範如何在遊戲中整合成就和排行榜。
步驟 1:下載範例應用程式
在這個開發人員指南中,您必須下載 Type-a-Number Challenge 範例 Android 應用程式。
如要在 Android Studio 中下載並設定範例應用程式:
- 前往範例下載頁面下載 Android 範例。
- 匯入
android-basic-samples
專案。這項專案包含TypeANumber
和其他 Android 遊戲範例。如要在 Android Studio 中執行此操作:- 依序點選「File」 >「Import Project」。
- 前往您在開發機器上下載
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 管理中心。
- 當系統詢問您是否在應用程式中使用 Google API 時,請選取 [尚未在遊戲中使用任何 Google API]。
- 以這份指南來說,您可以在表單中填入自己的遊戲詳細資料。為了方便起見,您可以使用「下載」頁面提供的預留位置圖示和螢幕截圖。
- 請按照這些操作說明為您的 Android 應用程式產生 OAuth 2.0 用戶端 ID。
- 連結 Android 應用程式時,請務必指定之前在重新命名範例套件時,使用的確切套件名稱。
- 如果您還沒有 KeyStore 和已簽署的憑證,可以使用 Android Studio 中的「Generate Signed APK」精靈來產生新的 KeyStore 和簽署憑證。如要瞭解如何執行「Generate Signed APK」精靈,請參閱「在 Android Studio 中簽署應用程式」。
- 請務必記錄以下資訊供日後使用:
- 您的應用程式 ID:該字串僅包含數字 (通常有 12 個以上),位於用戶端 ID 的開頭。
- 您的簽署憑證:記下您在設定 API 存取權時使用的憑證 (您提供的 SHA1 指紋的憑證)。測試或發布應用程式時,您應使用相同的憑證簽署應用程式。
- 設定 Type-a-Number Challenge 的成就:
- 在 Google Play 管理中心選取「成就」分頁標籤。
- 新增下列成就範例:
名稱 說明 特殊指示 角分符號 取得質數為質數的分數。 無 Humble 要求的分數為 0。 無 不要讓孩子相信 在兩種模式中要求分數為 9999。 無 天啊! 獲得 1337 分。 將此設定為隱藏成就。 無聊 遊玩遊戲 10 次。 將此設為需要完成 10 個步驟才能解鎖的漸進式成就。 非常無聊 遊玩遊戲 100 次。 將此設為需要完成 100 個步驟才能解鎖的漸進式成就。 - 記錄您建立的每個成就的 ID (長英數字元字串)。
- 設定您遊戲適用的成就。詳情請參閱「成就背後的概念」與「如何在 Android 中實作成就」。
- 設定 Type-a-Number Challenge 的排行榜:
- 在 Google Play 管理中心選取「排行榜」分頁標籤。
- 新增兩個範例排行榜:一個名稱為「Easy High Scores」,另一個名為「Hard High Scores」。兩個排行榜都應使用整數分數格式,且小數位數為 0,而排序類型為「Larger isBetter」。
- 記錄您建立的每個排行榜的 ID (長英數字元字串)。
- 設定您遊戲適用的排行榜。詳情請參閱「排行榜背後的概念」和「如何在 Android 中實作排行榜」。
- 新增遊戲的測試帳戶。 只有尚未在 Google Play 管理中心發布的應用程式,才需要執行這個步驟。發布應用程式前,只有 Google Play 管理中心中列出的測試帳戶才能登入。然而,應用程式發布後,所有使用者皆可登入。
步驟 3:修改程式碼
如要執行遊戲,您必須將應用程式 ID 設為 Android 專案中的資源。此外,您也必須在 AndroidManifest.xml
中新增遊戲中繼資料。
- 開啟
res/values/ids.xml
並取代預留位置 ID。如要從頭開始建立 Android 遊戲,您必須先建立這個檔案。- 在
app_id
資源中指定應用程式 ID。 - 在對應的
achievement_*
資源中指定您先前建立的各個成就 ID。 - 在對應的
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,請依序點選「Build」 >「Generate Signed APK」。
- 使用
adb
工具在實體測試裝置上安裝已簽署的 APK。如要瞭解如何安裝應用程式,請參閱「在裝置上執行」。