Play Games サービス v2 に移行する（Unity）

このドキュメントでは、既存のゲームを games v1 SDK から games v2 SDKに移行する方法について説明します。 バージョン 10 以前の Unity 用 Google Play Games プラグインは、games v1 SDK を使用します。

始める前に

• Google Play Console を設定し、Unity エディタをインストールしていることを確認します。

Unity 用 Google Play Games プラグインをダウンロードする

Play Games サービスの最新機能を利用するには、最新バージョンのプラグインをダウンロードしてインストールします。gitHub リポジトリからダウンロードしてください。

古いプラグインを削除する

Unity エディタで、次のフォルダまたはファイルを削除します。

Assets/GooglePlayGames

Assets/GeneratedLocalRepo/GooglePlayGames

Assets/Plugins/Android/GooglePlayGamesManifest.androidlib

Assets/Plugins/Android

新しいプラグインを Unity プロジェクトにインポートする

プラグインを Unity プロジェクトにインポートする手順は、次のとおりです。

1. ゲーム プロジェクトを開きます。
2. Unity エディタで、[Assets > Import Package > Custom Package] をクリックして、ダウンロードした unitypackage ファイルをプロジェクトのアセットにインポートします。

3. 現在のビルド プラットフォームが Android に設定されていることを確認します。

   1. メインメニューで、[File] > [Build Settings] をクリックします。

   2. [Android] を選択し、[Switch Platform] をクリックします。

   3. [Window] > [Google Play Games] に新しいメニュー項目が表示されます。表示されない場合は、[Assets] > [Refresh] をクリックしてアセットを更新し、もう一度ビルド プラットフォームを設定してみてください。

4. Unity エディタで、[File] > [Build Settings] > [Player Settings] > [Other Settings] をクリックします。

5. [対象 API レベル] ボックスで、バージョンを選択します。

6. [Scripting backend] ボックスに「IL2CPP」と入力します。

7. [Target architectures] ボックスで、値を選択します。

8. パッケージ名 package_name をメモします。この情報 は後で使用できます。

   

9. Google Play Console から Android リソースをコピーする

10. Unity プロジェクトに Android リソースを追加する

移行パス

ゲームの適切な移行パスは、ゲームで Play ゲームサービス v1 を実装する方法と、プレーヤー ID の処理方法によって異なります。スムーズな移行を実現し、プレーヤー データの損失を防ぐため、既存の設定に最も適したシナリオを特定し、対応する手順に沿って操作してください。

オプション 1: IGA が Play ゲームサービス プレーヤー ID にバインドされているゲームの場合

このシナリオは、Play Games サービス Player ID をプレーヤーのゲーム内アカウント（IGA）の一意の識別子として使用し、以前に OpenID をリクエストまたは保存していないゲームに適用されます。主な課題は、プレーヤーの進捗状況との接続を維持しながら、既存の IGA をプライマリ識別子（OpenID）にリンクすることです。

移行フローには次の手順が含まれます。

1. ゲームが起動すると、Play Games サービス v2 SDK はプラットフォームを自動的にサイレント認証します。

2. ゲームのログイン画面が表示されます。この画面には、[Sign in with Google]（SiWG） ボタンの代わりに [Google Play] ボタンが表示される必要があります。統合するには:

   1. CredManBridge.java を フォルダにダウンロードします。この Java クラスは、Unity と androidx.credentials ライブラリ間のブリッジとして機能します。

      CredManBridge.java

      
      package com.wickedcube.trivialkart;
      import android.accounts.Account;
      import android.content.Context;
      import android.util.Log;
      import android.os.CancellationSignal;
      import androidx.credentials.CredentialManager;
      import androidx.credentials.GetCredentialRequest;
      import androidx.credentials.GetCredentialResponse;
      import androidx.credentials.exceptions.GetCredentialException;
      import androidx.credentials.exceptions.NoCredentialException;
      import com.google.android.libraries.identity.googleid.GetGoogleIdOption;
      import com.google.android.libraries.identity.googleid.GoogleIdTokenCredential;
      import com.google.android.gms.auth.api.identity.AuthorizationClient;
      import com.google.android.gms.auth.api.identity.AuthorizationRequest;
      import com.google.android.gms.auth.api.identity.AuthorizationResult;
      import com.google.android.gms.common.api.ApiException;
      import com.google.android.gms.auth.api.identity.Identity;
      import com.google.android.gms.common.api.Scope;
      import com.unity3d.player.UnityPlayer;
      import java.util.Collections;
      import java.util.List;
      import java.util.concurrent.Executor;
      import java.util.concurrent.Executors;
      
      
      public class CredManBridge {
      
      // --- MODE 1: SILENT SIGN-IN (Called on Awake) ---
      // Tries to auto-select an authorized account. If it fails, it does NOT show UI.
      public static void signInSilent(Context context, String webClientId) {
        CredentialManager credentialManager = CredentialManager.create(context);
        CancellationSignal cancellationSignal = new CancellationSignal();
        Executor executor = Executors.newSingleThreadExecutor();
      
      Log.d("CredMan", "Attempting Silent Sign-In...");
      
      GetGoogleIdOption silentOption = new GetGoogleIdOption.Builder()
          .setFilterByAuthorizedAccounts(true) // Strict: Only authorized accounts
          .setServerClientId(webClientId)
          .setAutoSelectEnabled(true)          // Auto-select if possible
          .build();
      
      GetCredentialRequest silentRequest = new GetCredentialRequest.Builder()
          .addCredentialOption(silentOption)
          .build();
      
      credentialManager.getCredentialAsync(
          context,
          silentRequest,
          cancellationSignal,
          executor,
          new androidx.credentials.CredentialManagerCallback<GetCredentialResponse, GetCredentialException>() {
              @Override
              public void onResult(GetCredentialResponse result) {
                  Log.d("CredMan", "Silent Sign-In Successful!");
                  handleSignInResult(context, result, webClientId);
              }
          @Override
          public void onError(GetCredentialException e) {
              // Send a specific error code so Unity knows to just stay on the Start Screen
              Log.d("CredMan", "Silent sign-in failed. Keeping UI hidden.");
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "SilentFailed");
          }
      }
      
      );
      }
      
      // --- MODE 2: INTERACTIVE SIGN-IN (Called on Button Click) ---
      // Forces the Account Selection / "Add Account" sheet to appear.
      public static void signInInteractive(Context context, String webClientId) {
        CredentialManager credentialManager = CredentialManager.create(context);
        CancellationSignal cancellationSignal = new CancellationSignal();
        Executor executor = Executors.newSingleThreadExecutor();
      
      Log.d("CredMan", "Starting Interactive Sign-In...");
      
      GetGoogleIdOption interactiveOption = new GetGoogleIdOption.Builder()
          .setFilterByAuthorizedAccounts(false) // Show ALL accounts (and "Add Account")
          .setServerClientId(webClientId)
          .setAutoSelectEnabled(false)          // Force the UI to show
          .build();
      
      GetCredentialRequest interactiveRequest = new GetCredentialRequest.Builder()
          .addCredentialOption(interactiveOption)
          .build();
      
      credentialManager.getCredentialAsync(
          context,
          interactiveRequest,
          cancellationSignal,
          executor,
          new androidx.credentials.CredentialManagerCallback<getcredentialresponse, getcredentialexception="">() {
              @Override
              public void onResult(GetCredentialResponse result) {
                  Log.d("CredMan", "Interactive Sign-In Successful!");
                  handleSignInResult(context, result, webClientId);
              }</getcredentialresponse,>
          @Override
          public void onError(GetCredentialException e) {
              Log.e("CredMan", "Interactive Sign-In Canceled or Failed", e);
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Canceled");
          }
      }
      
      );
      }
      
      private static void handleSignInResult(Context context, GetCredentialResponse result, String webClientId) {
        try {
          GoogleIdTokenCredential credential = GoogleIdTokenCredential.createFrom(result.getCredential().getData());
          String email = credential.getId();
      Account account = new Account(email, "com.google");
      // Requesting GAMES_LITE scope to check for pre-existing V1 grants
      List<Scope> requestedScopes = Collections.singletonList(new Scope("https://www.googleapis.com/auth/games_lite"));
      
      AuthorizationRequest authRequest = new AuthorizationRequest.Builder()
          .setRequestedScopes(requestedScopes)
          .setAccount(account)
          .requestOfflineAccess(webClientId)
          .build();
      
      AuthorizationClient authClient = Identity.getAuthorizationClient(context);
      
      authClient.authorize(authRequest)
          .addOnSuccessListener(authorizationResult -> {
              if (authorizationResult.getServerAuthCode() != null) {
                  // CASE 1: RETURNING USER (Success)
                  // The user has already granted GAMES_LITE in the past.
                  // We got the code directly without showing UI.
                  Log.i("CredMan", "PGS v1: Existing grant found. Returning user detected. Auth Code retrieved.");
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInSuccess", authorizationResult.getServerAuthCode());
              }
              else if (authorizationResult.hasResolution()) {
                  // CASE 2: NEW USER (PendingIntent)
                  // The user has NOT granted GAMES_LITE before. The API returned a PendingIntent
                  // (authorizationResult.getPendingIntent()) to show the consent screen.
                  // As per your flow, we DISCARD this intent and do not show UI.
                  Log.i("CredMan", "PGS v1: No existing grant (PendingIntent returned). This is a NEW user or they revoked access.");
                  Log.i("CredMan", "PGS v1: Discarding PendingIntent. Proceeding as New User.");
      
                  // Notify Unity that this is a "New User" so it can trigger V2 logic instead of failing
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "NewUser_NoGrant");
              }
              else {
                  // Edge Case: No code and no resolution?
                  Log.e("CredMan", "PGS v1: Authorization success but no Auth Code or Resolution returned.");
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "No Auth Code returned");
              }
          })
          .addOnFailureListener(e -> {
              // CASE 3: GENERIC FAILURE
              Log.e("CredMan", "PGS v1: Authorization failed completely.", e);
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Authorization Failed: " + e.getMessage());
          });
      
      } catch (Exception e) {
          UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Parsing Error: " + e.getMessage());
      }
      }
      }
      
      
      
      

   2. 認証情報マネージャーの統合:

      • サイレント ログインには、setFilterByAuthorizedAccounts(true) を指定した GetGoogleIdOption を使用して、アプリを以前に承認したユーザーのみをログインさせます。
      • インタラクティブ ログインには setFilterByAuthorizedAccounts(false) を使用して、ユーザーがアカウントを選択したり、新しいアカウントを追加したりできるようにします。

   3. スコープ リクエスト:

      • 基本の Google 認証情報を取得すると、特定のレガシー スコープ（ https://www.googleapis.com/auth/games_lite）をリクエストする AuthorizationRequestが作成されます。
      • このスコープは、サーバーにユーザーのレガシー PlayerID を検索する権限を付与するため、非常に重要です。

   4. 結果の処理:

      • ユーザーが権限を付与した場合（または以前に付与している場合）、ブリッジは ServerAuthCode を Unity に返します。
      • ユーザーが権限を付与していない場合（新規ユーザーのシナリオ）、API は PendingIntent を返します。このサンプルでは、フローを簡略化するために、インテントは破棄され、ユーザーは新規ユーザーとして扱われます。

3. 認証情報マネージャーと Google Identity サービスをサポートするには、次の依存関係が mainTemplate.gradle Gradle 構成に追加されていることを確認します。

   dependencies {
   // Standard Unity dependencies
   implementation fileTree(dir: 'libs', include: ['*.jar'])
   
   // Credential Manager and Identity Libraries
   implementation 'androidx.credentials:credentials:1.3.0'
   implementation 'androidx.credentials:credentials-play-services-auth:1.3.0'
   implementation 'com.google.android.libraries.identity.googleid:googleid:1.1.1'
   
   // Play Services Auth for legacy scope handling
   implementation 'com.google.android.gms:play-services-auth:21.2.0'
   }

   • 認証情報マネージャー: アカウント選択のコア ID オーケストレーションと UI を処理します。
   • GoogleID ライブラリ: OpenID Connect トークンを取得するための GetGoogleIdOption を提供します。
   • Play 開発者サービス認証: 互換性を維持し、レガシー Player ID を取得するために GAMES_LITE スコープをリクエストする必要があります。

4. プレーヤーが SiWG ボタンをタップして Google アカウントを選択すると、ゲームは次の 2 つの異なる識別子を取得する必要があります。

   • OpenID。IGA をバインドするためのプライマリ識別子。
   • Play Games サービス Player ID。GAMES_LITE スコープを使用して取得し、バックエンド システムでプレーヤーの IGA を検索してバインドします。

5. 以降のゲームの起動では、プレーヤーは SiWG フローを使用して IGA にアクセスできます。ゲームで Player ID をプライマリ識別子として使用する必要はありません。

using GooglePlayGames;
using GooglePlayGames.BasicApi;
using UnityEngine.SocialPlatforms;

public void Start() {
    PlayGamesClientConfiguration config =
        new PlayGamesClientConfiguration.Builder()
    // Enables saving game progress
    .EnableSavedGames()
    // Requests the email address of the player be available
    // will bring up a prompt for consent
    .RequestEmail()
    // Requests a server auth code be generated so it can be passed to an
    // associated backend server application and exchanged for an OAuth token
    .RequestServerAuthCode(false)
    // Requests an ID token be generated. This OAuth token can be used to
    // identify the player to other services such as Firebase.
    .RequestIdToken()
    .Build();

    PlayGamesPlatform.InitializeInstance(config);
    // recommended for debugging:
    PlayGamesPlatform.DebugLogEnabled = true;
    // Activate the Google Play Games platform
    PlayGamesPlatform.Activate();
}

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).
    }
}

// sign out
PlayGamesPlatform.Instance.SignOut();