開始使用 Android 版 Play 遊戲服務

事前準備

本開發人員指南說明如何在 Android 上使用 Google Play 編譯及執行 C++ 遊戲 Game Services API。開始之前，請先下載並設定下列需求條件：

本開發人員指南使用 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。擷取 安裝至開發機器在環境中，將變數 NDK_MODULE_PATH 設為 指向 gpg-cpp-sdk 目錄「上方」的目錄。備妥下列物品 目錄結構： 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. 開啟 Eclipse。如果您尚未告知 Eclipse 您安裝 NDK by 按一下 [偏好設定] > Android >NDK。

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

    1. 在 Eclipse 中，按一下 檔案 >匯入 >Android >將現有 Android 程式碼插入 Workspace。
    2. 選取「SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib」 其中 SDK_ROOT 是 Android SDK 的位置。
    3. 按一下 [完成]。

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

    1. 在 Eclipse 中，按一下 檔案 >匯入 >Android >將現有 Android 程式碼插入 Workspace。
    2. 選取「SAMPLES_DIR/samples-android/minimalist」。
    3. 按一下 [完成]。

  7. 在 MinimalistActivity 專案上按一下滑鼠右鍵，然後點選「Properties」。在「Android」Android下方，捲動畫面 找到「程式庫」部分，確定 google-play-services_lib 專案已正確設定 參照。如果沒有，請移除參照，然後在工作區中重新新增。

Eclipse 會自動編譯專案的 Java 和 Android 來源。不過， jni 資料夾中的原生程式碼需要分開編譯。如要手動操作，請前往 然後執行 ndk-build 資料夾。jni別忘了在 jni 資料夾。

您的專案現在應已編譯，但無法執行。您必須先設定遊戲 。

步驟 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；也就是遊戲在「遊戲詳細資料」頁面中，遊戲名稱旁邊的數字。 Google Play 管理中心。

步驟 3：執行範例

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

  1. 執行 ndk-build 編譯原生程式碼。
  2. 在 Eclipse 中，按一下 執行 >執行身分 >Android 應用程式，然後在裝置上執行範例。
  3. 試聽內容開啟後，輕觸片段上的任一處。您應該會看到 Google Play 遊戲標誌 顯示。如已正確設定應用程式，系統會提示您登入。

選用：使用 Eclipse 自動建立

下列步驟會說明如何設定 Eclipse 在執行 ndk-build 時 對「jni」資料夾中的檔案進行變更。

  1. 在 MinimalistActivity 專案上按一下滑鼠右鍵，然後點選「Properties」。在「屬性」視窗中 選取「Builders」窗格。
  2. 按一下「New」新增建構工具，然後依序選取「Program」和「OK」。
  3. 在「Name」(名稱) 欄位中，輸入「NDK Builder」。
  4. 在「位置」下方，按一下「瀏覽檔案系統」，然後前往 NDK_ROOT 目錄， 選取 ndk-build 指令
  5. 在「工作目錄」下方，按一下「瀏覽工作區」，然後選取「MinmalistActivity」。 專案資料夾
  6. 按一下「重新整理」分頁標籤。確認已勾選「在完成後重新整理資源」方塊。
  7. 選取「Specific resources」圓形按鈕，然後按一下「Assign Resources」。在 對話方塊中，請選取 MinimalActivity 下方的 jni 資料夾。
  8. 依序按一下「Apply」和「OK」完成建構工具建立程序。

現在，每當您編輯 jni 資料夾中的檔案時，Eclipse 都會執行 ndk-build 並將 發布至 Eclipse 控制台