面向 Android 平臺的 Play 游戲服務使用入門

歡迎使用Google Play游戲服務開發(fā)Android游戲！

Play游戲SDK提供了跨平臺Google Play游戲服務，讓您可以輕松地在針對平板電腦和手機而設計的游戲中集成熱門的游戲功能，例如成就、排行榜、游戲存檔和實時多人游戲（Android平臺）。

在本培訓中，您將安裝一款針對Android平臺而設計的示例游戲應用，參照該示例快速掌握開發(fā)Android游戲的方法。Type-a-Number Challenge示例應用展示了如何將成就和排行榜功能集成到您的游戲中。

準備工作

·設置您的Android開發(fā)環(huán)境。如果您還不熟悉Android應用開發(fā)，請參閱構建首個應用。

·備好一臺用于測試的Android設備，該設備應搭載Android 4.0(Ice Cream Sandwich)或更高版本。

第1步：下載示例應用

針對本開發(fā)者指南，您需要下載名為Type-a-Number Challenge的Android示例應用。

要下載示例應用并在Android Studio中對其進行設置，請按照以下步驟操作：

1.從示例下載頁面中下載Android示例應用。

2.導入android-basic-samples項目。此項目中包含TypeANumber及其他Android游戲示例。在Android Studio中導入該項目的方法如下：

a.依次點擊File>Import Project。

b.在您用于開發(fā)的計算機上，找到您下載的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管理中心內(nèi)設置游戲

您可以在Google Play管理中心內(nèi)管理Google Play游戲服務，以及配置用于對游戲進行授權和身份驗證的元數(shù)據(jù)。

要在Google Play管理中心內(nèi)設置示例游戲，請按照以下步驟操作：

1.使用您的網(wǎng)絡瀏覽器訪問Google Play管理中心，然后登錄您的帳號。如果您之前還沒有在Google Play管理中心注冊過，系統(tǒng)會提示您進行注冊。

2.按照以下說明將您的游戲添加到Google Play管理中心。

a.當系統(tǒng)詢問您是否在應用中使用Google API時，選擇我尚未在自己的游戲中使用任何Google API。

b.針對本開發(fā)者指南中的示例，您可以使用自己的游戲詳細信息填寫表單。為方便起見，您可以使用下載頁面中提供的占位圖標和屏幕截圖。

3.按照以下說明為您的Android應用生成OAuth 2.0客戶端ID。

a.在關聯(lián)您的Android應用時，指定的軟件包名稱必須是您之前重命名示例軟件包時使用的那個名稱。

b.如果您尚未生成密鑰庫和簽名證書，可以使用Android Studio中的Generate Signed APK Wizard生成密鑰庫和簽名證書。要了解如何運行Generate Signed APK Wizard，請參閱在Android Studio中為應用簽名。

4.務必記錄下列信息，以供稍后使用：

a.您的應用ID：這是位于您的客戶端ID開頭部分的一個字符串，它僅包含數(shù)字，通常長度至少為12位。

b.您的簽名證書：記下您在設置API訪問權限時使用的證書（您提供的SHA1指紋所對應的證書）。在您測試或發(fā)布該應用時，也應該使用同一證書為應用簽名。

5.為Type-a-Number Challenge配置成就：

a.在Google Play管理中心內(nèi)選擇成就標簽。

b.添加以下示例成就：

c.記錄您所創(chuàng)建的每個成就的ID（由字母和數(shù)字組成的長字符串）。

d.根據(jù)您的游戲內(nèi)容，配置適合的成就。要了解詳情，請參閱成就背后的概念和如何在Android應用中實現(xiàn)成就功能。

6.為Type-a-Number Challenge配置排行榜：

a.在Google Play管理中心內(nèi)選擇排行榜標簽。

b.添加兩個示例排行榜：一個名為“Easy High Scores”（低難度得分排行榜），另一個名為“Hard High Scores”（高難度得分排行榜）。兩個排行榜均應采用整數(shù)得分格式，不帶小數(shù)位，排序類型采用越高越好。

c.記錄您所創(chuàng)建的每個排行榜的ID（由字母和數(shù)字組成的長字符串）。

d.根據(jù)您的游戲內(nèi)容，配置適合的排行榜。要了解詳情，請參閱排行榜背后的概念和如何在Android應用中實現(xiàn)排行榜功能。

7.為您的游戲添加測試帳號。只有在應用尚未在Google Play管理中心發(fā)布的情況下，才需要執(zhí)行此步驟。在應用發(fā)布之前，只有Google Play管理中心內(nèi)列出的測試帳號才能登錄。不過，應用一旦發(fā)布，就所有人都可以登錄了。

警告：如果您嘗試使用未列為測試帳號的帳號對尚未發(fā)布的游戲執(zhí)行Play游戲SDK調用，Google Play游戲服務會按照游戲不存在來處理，您會收到ConnectionResult.SIGN_IN_REQUIRED返回代碼。如果您嘗試啟動ConnectionResult.startResolutionForResult()，則會收到GamesActivityResultCodes.RESULT_SIGN_IN_FAILED。

第3步：修改代碼

要運行游戲，您需要在Android項目中將其應用ID配置為一項資源。您還需要在AndroidManifest.xml中添加游戲元數(shù)據(jù)。

1.打開res/values/ids.xml并替換占位符ID。如果您是從頭開始創(chuàng)建Android游戲，則需要先創(chuàng)建此文件。

a.在app_id資源中指定您的應用ID。

b.指定您之前在相應的achievement_*資源中創(chuàng)建的每個成就ID。

c.指定您之前在相應的leaderboard_*資源中創(chuàng)建的每個排行榜ID。

2.打開AndroidManifest.xml并在<manifest>元素的package屬性中輸入您的軟件包名稱。如果您是從頭開始創(chuàng)建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游戲服務在您的游戲中能正常運行，請在將其發(fā)布到Google Play上之前進行測試。

注意：我們建議您在實際Android設備上進行測試。不過，如果您沒有實際設備，也可以使用Android模擬器進行測試。要使用模擬器展開測試，請從SDK管理器中的Android 4.2.2下方下載包含Google Play服務的模擬器系統(tǒng)映像。

要在您的實際測試設備上運行游戲，請按照以下步驟操作：

1.確認您已設置用于登錄該應用的測試帳號（如第2步中所述）。

2.導出該應用的APK，并使用您在Google Play管理中心設置項目時所用的證書為其簽名。要在Android Studio中導出已簽名的APK，請依次點擊Build>Generate Signed APK。

3.使用adb工具在您的實際測試設備上安裝已簽名的APK。要了解如何安裝應用，請參閱在設備上運行您的應用。

警告：如果您直接從Android Studio中運行應用，Android Studio會默認使用您的調試證書為該應用簽名。如果您在Google Play管理中心內(nèi)設置應用時所用的并不是此調試證書，便會導致出現(xiàn)錯誤。因此，請務必先將APK導出后再運行，并且確保為其簽名時使用的證書與您在Google Play管理中心內(nèi)設置應用時所用的某個證書相同。