登入 Android 遊戲

如果要存取 Google Play 遊戲服務功能,遊戲必須提供已登入玩家的帳戶。本文件說明如何在遊戲中實作順暢的登入體驗。

Play 遊戲服務第 2 版 SDK 提供多項改善功能,可增加登入遊戲的使用者人數,也能簡化開發作業:

  • 使用者改善功能:
    • 選取預設帳戶後,使用者不需要有登入提示也可以登入。
    • 使用者不再需要下載 Play 遊戲應用程式,即可使用 Play 遊戲服務登入或建立新帳戶。
    • 使用者現在可以在單一頁面中管理多個遊戲的 Play 遊戲服務帳戶。
  • 開發人員改善功能:
    • 用戶端程式碼不再需要處理登入或登出流程,因為系統會在遊戲開始時自動觸發登入程序,並在 OS 設定中處理帳戶管理。

新用戶端與 Play 遊戲服務登入功能第 2 版整合

本節說明如何使用 Play 遊戲服務登入第 2 版執行新用戶端整合。

新增 Play 遊戲服務 SDK 依附元件

在應用程式的根目錄層級 build.gradle 檔案中加入 Play 遊戲服務 SDK 依附元件。如果使用的是 Gradle,則可以新增或更新依附元件,如下所示:

dependencies {
 implementation "com.google.android.gms:play-services-games-v2:+"
}

定義 Play 遊戲服務專案 ID

如要在應用程式中加入 Play 遊戲服務 SDK 專案 ID,請完成下列步驟:

  1. 在應用程式的 AndroidManifest.xml 檔案中,將下列 <meta-data> 元素和屬性新增至 <application> 元素:

    <manifest>
      <application>
        <meta-data android:name="com.google.android.gms.games.APP_ID"
                   android:value="@string/game_services_project_id"/>
      </application>
    </manifest>
    

    使用遊戲的遊戲服務專案 ID 為值,定義字串資源參考資料 @string/game_services_project_id。遊戲服務專案 ID 會在 Google Play 管理中心「Configuration」頁面的遊戲名稱下方顯示。

  2. res/values/strings.xml 檔案中,新增字串資源參考資料,並將專案 ID 設為該值。在 Google Play 管理中心的「Configuration」頁面中,專案 ID 會在遊戲名稱下方顯示。例如:

    <!-- res/values/strings.xml -->
    <resources>
      <!-- Replace 0000000000 with your game’s project id. Example value shown above.  -->
      <string translatable="false"  name="game_services_project_id"> 0000000000 </string>
    </resources>
    

初始化 SDK

Application 類別的 onCreate(..) 回呼中初始化 Play 遊戲 SDK。

import com.google.android.gms.games.PlayGamesSdk;

...

@Override
public void onCreate(){
  super.onCreate();
  PlayGamesSdk.initialize(this);
}

取得登入程序結果

遊戲啟動後,一律會嘗試登入使用者。如要驗證使用者,您必須驗證使用者是否已成功登入,然後取得他們的玩家 ID。

如要驗證登入嘗試,請呼叫 GamesSignInClient.isAuthenticated() 並使用 addOnCompleteListener 擷取結果。例如:

GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(getActivity());

gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
  boolean isAuthenticated =
    (isAuthenticatedTask.isSuccessful() &&
     isAuthenticatedTask.getResult().isAuthenticated());

  if (isAuthenticated) {
    // Continue with Play Games Services
  } else {
    // Disable your integration with Play Games Services or show a
    // login button to ask  players to sign-in. Clicking it should
    // call GamesSignInClient.signIn().
  }
});

如果使用者選擇不在遊戲啟動時登入,可以選擇繼續顯示附有 Play 遊戲圖示的按鈕,然後在使用者按下按鈕時呼叫 GamesSignInClient.signIn(),嘗試再次登入使用者。

驗證使用者登入之後,就可以擷取玩家 ID 以辨識使用者。例如:

PlayGames.getPlayersClient(activity).getCurrentPlayer().addOnCompleteListener(mTask -> {
    // Get PlayerID with mTask.getResult().getPlayerId()
  }
);