歡迎使用 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 中下載並設定範例應用程式:
- 從範例下載頁面下載 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:這是用戶端 ID 開頭僅包含數字 (通常有 12 個以上) 的字串。
- 您的簽署憑證:記下您在設定 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。如要瞭解如何安裝應用程式,請參閱在裝置上執行。