開始使用 Unity 專用 Google Play 遊戲外掛程式

本主題將說明如何設定 Unity 專案，在當中使用 Unity 專用 Google Play 遊戲外掛程式。相關工作包括設定專案、選擇社群平台，以及設定玩家登入程序。

事前準備

• 在 Google Play 管理中心，為您的遊戲設定 Play 管理中心。

• 在 Google Play 管理中心建立成就。

安裝外掛程式

1. 請透過以下其中一種方式取得外掛程式：

   • 複製 GitHub 存放區 新增到您的檔案系統。

   • 下載 GitHub 存放區 壓縮成 ZIP 檔案，然後解壓縮。

2. 前往 current-build 目錄找出 unitypackage 檔案。這個檔案就是外掛程式。例如，檔案應如下所示：

     current-build/GooglePlayGamesPluginForUnity-X.YY.ZZ.unitypackage
   

3. 在 Unity 中開啟遊戲專案。

4. 依序點選「Assets」>「Import Package」>「Custom Package」選單項目，將 unitypackage 檔案匯入至專案的資產。

5. 確認目前的建構平台已設為「Android」。

   1. 依序點選主選單的「File」>「Build Settings…」。

   2. 選取「Android」，然後點選「Switch Platform」。

   3. 依序前往「Window」>「Google Play Games」，應該會顯示新的選單項目。如果沒有顯示，請依序點選「Assets」>「Refresh」重新整理資產，再嘗試重新設定建構平台。

從 Play 管理中心取得 Android 資源

您在 Play 管理中心建立的所有成就、排行榜及事件都會內含您在設定 Unity 專案時使用的 Android 資源。

1. 取得遊戲的 Android 資源。

   1. 在 Play 管理中心，開啟遊戲的 Play 遊戲服務專案。

   2. 依序點選「Achievements」分頁標籤 >「Get resources」。

   3. 點選「Export resources」視窗中的「Android」分頁標籤。

   4. 選取並複製 XML 內容。

設定 Unity 專案

1. 將 Android 資源加入 Unity 專案中。

   1. 在 Unity 中，依序點選 **「Window」>「Google Play Games」>「Setup…」>「Android Setup」**。

   2. 在設定視窗中填寫以下項目：

   3. Directory to save constants：常數檔案的資料夾。

   4. Constants class name：要建立的 C# 類別名稱，包括命名空間。

   5. Resources Definition：在此貼上從 Play 管理中心複製的 Android 資源資料。

   6. Web client ID：已連結網頁應用程式的用戶端 ID。只有兩種情況需要使用這類 ID：一種情況是遊戲使用網頁式後端伺服器，而且需由後端伺服器使用伺服器授權碼交換存取權杖，另一種情況是您需要使用玩家的 ID 權杖，發出其他非遊戲的 API 呼叫。

   7. 點選「Setup」。這樣做會使用用戶端 ID 設定遊戲，並產生含有各 Android 資源所用常數的 C# 類別。

Android 設定

在 Unity 中設定指向 Android SDK 安裝的路徑。這項設定位於「External Tools」部分下方的「Preferences」選單中。

如要設定 Unity 遊戲在 Android 上搭配 Google Play 遊戲運作，請先開啟 Android SDK Manager 並確認已下載以下套件。根據您使用的是 Android Studio 提供的 SDK Manager，還是獨立的 SDK 管理工具，元件名稱可能會有差異。- Google Play 服務 - Android 支援資料庫 - 支援資料庫的本機 Maven 存放區 (也稱為 Android 支援存放區) - Google 存放區 - Android 6.0 (API 23) (這不會影響最低 SDK 版本)。

接下來，設定遊戲的套件名稱。如要設定套件名稱，請依序點選「File」>「Build Settings」，選取「Android」平台，再點選「Player Settings」，開啟 Unity 的「Player Settings」視窗。在該視窗中，找出「Other Settings」下方的「Bundle Identifier」設定，然後輸入套件名稱 (例如「com.example.my.awesome.game」)。

為登入 Play 遊戲服務，您需要簽署 APK 檔案，請務必使用正確的憑證簽署，也就是與您在 Play 管理中心設定時輸入的 SHA1 憑證指紋相對應的憑證。

接著，點選「WIndow」| Google Play Games | Setup - Android setup」選單項目。系統隨即顯示 Android 設定畫面。

輸入常數類別名稱。這是要更新 (或建立) 的完整類別名稱，內含遊戲資源 ID。名稱格式為 <namespace>.<classname>，例如：AwesomeGame.GPGSIds

貼上資源定義資料。這是 Google Play 管理中心提供的 XML 資料，內含適用於 Android 的資源 ID 以及應用程式 ID。

在 Google Play 管理中心任何資源頁面 (例如「Achievements」或「Leaderboards」) 中，依序點選「Get resources」>「Android」即可找到這些資料。

將資料貼到文字區域後，按一下「Setup」按鈕。

注意：如果遊戲搭配使用網頁應用程式或後端伺服器，可以將網頁應用程式連結至遊戲，取得玩家的 ID 權杖和/或電子郵件地址，方法是在 Google Play 管理中心將網頁應用程式連結至遊戲，然後在設定對話方塊中輸入網頁應用程式的用戶端 ID。

在 Windows 上建構 Android 遊戲的其他說明

如果要使用 Windows，必須確認 Unity 可以存取安裝的 Java SDK。方法如下：

1. 將 JAVA_HOME 環境變數設為 Java SDK 安裝路徑 (例如 C:\Program Files\Java\jdk1.7.0_45)。
2. 在 PATH 環境變數中加入 Java SDK 的 bin 資料夾，例如 C:\Program Files\Java\jdk1.7.0_45\bin。
3. 重新啟動。

如何編輯環境變數：如果是 Windows 2000/XP/Vista/7，在「我的電腦」上按一下滑鼠右鍵，點選「屬性」，前往「進階系統屬性」(或前往「系統屬性」的「進階」分頁)，然後點選「環境變數」。若是 Windows 8，請按下「Windows + W 鍵」，然後搜尋「環境變數」。詳情請參閱所用 Windows 版本的說明文件。

執行專案

如果您正在使用 Smoketest 範例，此時應該可以建構並執行專案。Smoketest 啟動時，會嘗試自動登入。

如要在 Android 系統上建構並執行，請依序點選「File」>「Build Settings」，然後依序選取「Android」平台 >「Switch to Platform」>「Build and Run」。

選擇社群平台

Google Play 遊戲外掛程式會實作 Unity 的社群介面，這樣才能在整合其他平台時，與已經使用該介面的遊戲相容。但是，有些 Play 遊戲專屬的功能，會以擴充功能的形式給 Unity 提供的標準社群介面使用。

Social.Active 物件是指向 ISocialPlatform 介面的參照，可用來存取標準 API 呼叫。只要將 Social.Active 物件層級轉換為可提供其他方法的 PlayGamesPlatform 類別，即可存取非標準的 Google Play 遊戲擴充功能。

使用外掛程式而不覆寫預設社群平台

如果呼叫 PlayGamesPlatform.Activate，Google Play 遊戲就會成為您實作的預設社群平台，這表示 Google Play 遊戲外掛程式會對 Social 和 Social.Active 中的方法發出靜態呼叫。使用此外掛程式的多數遊戲都會採用此行為。

不過，如果您出於某種原因，希望將預設實作社群平台保持可存取的狀態 (例如，需要透過此社群平台將成就和排行榜提交到其他社群平台)，可以使用 Google Play 遊戲外掛程式，但不覆寫預設社群平台。方法如下：

1. 不要呼叫 PlayGamesPlatform.Activate
2. 如果想對 Social 類別呼叫名為 Xyz 的方法，請不要呼叫 Social.Xyz，而是改為呼叫 PlayGamesPlatform.Instance.Xyz
3. 與 Google Play 遊戲互動時，不要使用 Social.Active，請改用 PlayGamesPlatform.Instance。

透過這種做法，甚至可以將得分和成就同時提交到兩個以上的社群平台：

    // Submit achievement to original default social platform
    Social.ReportProgress("MyAchievementIdHere", 100.0f, callback);

    // Submit achievement to Google Play
    PlayGamesPlatform.Instance.ReportProgress("MyGooglePlayAchievementIdHere", 100.0f, callback);

驗證登入服務

遊戲開啟後，系統會自動使用登入服務嘗試連線至 Play 遊戲服務。如果連線成功，遊戲就會顯示登入提示，且隨時可以使用 Unity 專用 Google Play 遊戲外掛程式。

如果使用者從未在這部裝置上使用過 Google Play 遊戲，系統會自動引導玩家進行一次性設定，建立 Play 遊戲帳戶。

在指令碼的 Start 方法中監聽自動登入嘗試結果、擷取驗證狀態，以及在使用者未登入時停用 Play 遊戲服務功能。

    using GooglePlayGames;

    public void Start() {
      PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
    }

    internal void ProcessAuthentication(SignInStatus status) {
      if (status == SignInStatus.Success) {
        // Continue with Play Games Services
      } else {
        // Disable your integration with Play Games Services or show a login button
        // to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
      }
    }
}

結果程式碼是一項列舉，可用來找出登入失敗的原因。

如果您偏好使用 Unity 的 Social 平台，可以改用下列程式碼：

  using GooglePlayGames;

  public void Start() {
    PlayGamesPlatform.Activate();
    Social.localUser.Authenticate(ProcessAuthentication);
  }

您必須先從 Authenticate 取得成功的傳回值，才能發出 Google Play 遊戲 API 呼叫。因此，建議遊戲在呼叫回呼之前持續顯示待機畫面，確保使用者先完成驗證才開始玩遊戲。

注意：如要進一步瞭解玩家 ID 的運作方式，請參閱新一代玩家 ID 相關主題

擷取伺服器驗證碼

您需要從用戶端應用程式取得驗證碼，並傳遞至網路伺服器應用程式，才能代表目前玩家存取後端網路伺服器上的 Google API。接著，系統可用這組驗證碼交換存取權杖，用來呼叫各種 API。如需瞭解工作流程，請參閱適用於網站的 Google 登入功能。

如何取得伺服器端存取碼：

1. 前往 Play 管理中心，設定連結至遊戲的網頁應用程式網路用戶端 ID。

2. 玩家通過驗證並取得伺服器端存取碼後，請呼叫 PlayGamesPlatform.Instance.RequestServerSideAccess。

3. 將這組存取碼傳遞至伺服器應用程式。

  PlayGamesPlatform.Instance.RequestServerSideAccess(
    /* forceRefreshToken= */ false,
    code -> {
      // send code to server
    });

設定並新增功能

• 啟用 Play 遊戲服務功能。

• 使用 Play Game Services API 新增以下遊戲功能：

  • 成就

  • 排行榜

  • 好友

  • 遊戲進度存檔

  • 玩家統計數據

  • 事件