歡迎使用 Google Play 遊戲服務開發 Android 遊戲!
Play 遊戲 SDK 提供跨平台的 Google Play 遊戲服務,可讓您在平板電腦和手遊中輕鬆整合熱門的遊戲功能,例如成就、排行榜和遊戲進度存檔。
本訓練課程將引導您安裝 Android 範例遊戲應用程式,並快速開始建立自己的 Android 遊戲。輸入數字挑戰範例應用程式示範如何將成就和排行榜整合至遊戲中。
事前準備
如要讓應用程式做好準備,請完成下列各節的步驟。
應用程式必要條件
請確認應用程式的版本檔案使用下列的值:
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 遊戲。輸入數字挑戰範例應用程式示範如何將成就和排行榜整合至遊戲中。
步驟 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 應用程式時,請務必指定您先前用於重新命名範例套件時使用的確切套件名稱。
- 如果您還沒有簽署憑證,可以使用 Android Studio 中的「Generate Signed APK Wizard」產生新的 KeyStore 和簽署憑證。如要瞭解如何執行「產生已簽署的 APK 精靈」,請參閱「在 Android Studio 中簽署應用程式」。
- 請務必記下下列資訊,以便日後使用:
- 應用程式 ID:這是一組只包含數字 (通常有 12 個以上) 的字串,位於用戶端 ID 開頭。
- 簽署憑證:請記下設定 API 存取權時使用的憑證 (您提供 SHA1 指紋的憑證)。測試或發布應用程式時,應使用相同的憑證簽署應用程式。
- 為「輸入數字」挑戰設定成就:
- 在 Google Play 管理中心選取「成就」分頁標籤。
- 新增下列範例關卡:
名稱 說明 特殊指示 Prime 獲得的分數為質數。 無 Humble 獲得的分數為 0。 無 Don't get cocky, kid 在兩種模式中獲得的分數都是 9999。 無 OMG U R TEH UBER LEET! 獲得的分數為 1337。 將此設為隱藏關卡。 Bored 遊玩遊戲 10 次。 將此設為需要完成 10 個步驟才能解鎖的漸進式關卡。 Really Really Bored 遊玩遊戲 100 次。 將此設為需要完成 100 個步驟才能解鎖的漸進式關卡。 - 記下您建立的每項成就的 ID (長的英數字元字串)。
- 設定您遊戲適用的關卡。如需更多資訊,請參閱成就背後的概念和如何在 Android 中實作成就。
- 設定輸入數字挑戰的排行榜:
- 在 Google Play 管理中心選取「排行榜」分頁標籤。
- 新增兩個排行榜範例:一個名為「Easy High Scores」,另一個名為「Hard High Scores」。兩個排行榜都應使用整數分數格式,小數點後 0 位,並以「Larger is better」做為排序類型。
- 記錄您建立的各個排行榜的 ID (含有字母和數字的長字串)。
- 設定您遊戲適用的排行榜。如需更多資訊,請參閱排行榜背後的概念和如何在 Android 中實作排行榜。
- 為遊戲新增測試帳戶。只有尚未在 Google Play 管理中心發布的應用程式,才需要執行這個步驟。在應用程式發布前,只有 Google Play 管理中心列出的測試帳戶可以登入。不過,一旦應用程式發布,所有使用者都可以登入。
步驟 3:修改程式碼
如要執行遊戲,您必須在 Android 專案中將應用程式 ID 設為資源。您也必須在 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。如要瞭解如何安裝應用程式,請參閱「在裝置上執行」。