開始使用 Android 版 Play 遊戲服務

本開發人員指南將說明如何在 Android 上編譯及執行使用 Google Play 遊戲服務 API 的 C++ 遊戲。開始前，請下載並設定下列必要條件：

本開發人員指南使用 Android Native Development Kit (NDK)。如果您不熟悉 NDK，請先參閱 NDK 說明文件和範例，再繼續操作。

步驟 1：設定環境

  1. 下載 Android SDK 和 Android NDK，並將其解壓縮至電腦。在環境中，將 SDK_ROOT 設為 Android SDK 資料夾的位置，並將 NDK_ROOT 設為 Android NDK 資料夾的位置。
  2. 下載 C++ 範例遊戲。本開發人員指南將電腦上範例的位置稱為 SAMPLES_DIR。
  3. 下載 Google Play 遊戲服務 C++ SDK。將 SDK 解壓縮至開發機器。在您的環境中，將 NDK_MODULE_PATH 變數設為指向 gpg-cpp-sdk 目錄上方的目錄。您應該會看到下列目錄結構：
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. 開啟 Eclipse。如果尚未完成，請按一下「Preferences」>「Android」>「NDK」，告訴 Eclipse 您安裝 NDK 的位置。

  5. 將 Google Play 服務程式庫專案匯入 Eclipse 工作區。

    1. 在 Eclipse 中，依序點選「File」>「Import」>「Android」>「Existing Android Code into Workspace」。
    2. 選取 SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib，其中 SDK_ROOT 是 Android SDK 的位置。
    3. 按一下「Finish」。

  6. 將極簡主義範例專案匯入 Eclipse 工作區。

    1. 在 Eclipse 中，依序點選「File」>「Import」>「Android」>「Existing Android Code into Workspace」。
    2. 選取「SAMPLES_DIR/samples-android/minimalist」。
    3. 按一下「Finish」。

  7. 在 MinimalistActivity 專案上按一下滑鼠右鍵，然後按一下「Properties」。在「Android」下方，向下捲動至「Library」部分，確認系統是否正確參照 google-play-services_lib 專案。如果不是，請移除參照，然後從工作區重新新增。

Eclipse 會自動編譯專案的 Java 和 Android 來源，但 jni 資料夾中的原生程式碼則需要另外編譯。如要手動執行這項操作，請前往 jni 資料夾並執行 ndk-build。請記得在 jni 資料夾中進行任何變更後執行這項操作。

您的專案現在應該可以編譯，但尚無法運作。您必須先在 Google Play 管理中心設定遊戲。

步驟 2：在 Google Play 管理中心設定遊戲

在 Google Play 管理中心建立遊戲項目。這麼做可為應用程式啟用遊戲服務，並建立 OAuth 2.0 用戶端 ID (如果尚未建立)。

  1. 按照「設定 Google Play 遊戲服務」一文的步驟，為遊戲建立項目。
  2. 在 AndroidManifest.xml 中，將 <manifest> 標記的 package 屬性變更為您在設定 Google Play 管理中心時所選的套件名稱。進行這項變更後，您可能需要修正專案中的一些參照 (特別是產生的 R 類別)。
  3. 開啟 res/values/ids.xml，然後將應用程式 ID 放在該處。請注意，應用程式 ID 與用戶端 ID 不同。應用程式 ID 是 Google Play 管理中心「遊戲詳細資料」頁面中，遊戲名稱旁邊的數字。

步驟 3：執行範例

如要執行範例，您需要實體 Android 裝置或已安裝 Google Play 服務的模擬器：

  1. 執行 ndk-build 來編譯原生程式碼。
  2. 在 Eclipse 中，依序點選「Run」>「Run As」>「Android Application」，然後在裝置上執行範例。
  3. 在範例開啟後，輕觸畫面上的任一位置。您應該會看到 Google Play 遊戲標誌。如果應用程式設定正確，系統會提示您登入。

選用：使用 Eclipse 自動建構

下列步驟說明如何設定 Eclipse，讓您在變更 jni 資料夾中的檔案時，自動執行 ndk-build。

  1. 在 MinimalistActivity 專案上按一下滑鼠右鍵，然後按一下「Properties」。在「Properties」視窗中，選取「Builders」窗格。
  2. 按一下「新增」來新增新的建構工具，然後選取「程式」，接著按一下「確定」。
  3. 在「Name」欄位中輸入「NDK Builder」。
  4. 在「位置」下方，按一下「瀏覽檔案系統」，然後前往 NDK_ROOT 目錄並選取 ndk-build 指令。
  5. 在「Working Directory」下方，按一下「Browse Workspace」，然後選取 MinimalistActivity 專案資料夾。
  6. 按一下「Refresh」分頁標籤。確認已勾選「Refresh resources upon completion」(完成後重新整理資源) 方塊。
  7. 選取「Specific resources」圓形按鈕，然後點選「Specify Resources」。在隨即顯示的對話方塊中，選取「MinimalActivity」下方的 jni 資料夾。
  8. 依序按一下「套用」和「確定」，即可完成建構工具的建立作業。

從現在開始，每當您在 jni 資料夾中編輯檔案時，Eclipse 就會執行 ndk-build，並將輸出內容列印到 Eclipse 主控台。