面向 Android 平臺的 Play 游戲服務(wù)使用入門

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

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

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

準(zhǔn)備工作

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

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

第1步：下載示例應(yīng)用

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

要下載示例應(yīng)用并在Android Studio中對其進(jìn)行設(shè)置，請按照以下步驟操作：

1.從示例下載頁面中下載Android示例應(yīng)用。

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

a.依次點(diǎn)擊File>Import Project。

b.在您用于開發(fā)的計算機(jī)上，找到您下載的android-basic-samples所在的目錄。選擇文件“android-basic-samples/build.gradle”，然后點(diǎn)擊OK。

3.在TypeANumber模塊中，打開AndroidManifest.xml，然后將軟件包名稱由com.google.example.games.tanc更改為自行指定的其他軟件包名稱。新的軟件包名稱不得以com.google、com.example或com.android開頭。

第2步：在Google Play管理中心內(nèi)設(shè)置游戲

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

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

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

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

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

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

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

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

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

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

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

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

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

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

b.添加以下示例成就：

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

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

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

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

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

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

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

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

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

第3步：修改代碼

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

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

a.在app_id資源中指定您的應(yīng)用ID。

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

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

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

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

要在您的實際測試設(shè)備上運(yùn)行游戲，請按照以下步驟操作：

1.確認(rèn)您已設(shè)置用于登錄該應(yīng)用的測試帳號（如第2步中所述）。

2.導(dǎo)出該應(yīng)用的APK，并使用您在Google Play管理中心設(shè)置項目時所用的證書為其簽名。要在Android Studio中導(dǎo)出已簽名的APK，請依次點(diǎn)擊Build>Generate Signed APK。

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

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