移行の概要

Google Play Games サービス、games v1 SDK は、サポートが終了し、2025 年に Google Play 開発者サービス Auth SDK（com.google.android.gms:play-services-auth）から削除される Android 版 Google ログインに依存しています。新しいゲームアプリは 2025 年までゲーム v1 を使用できます。Google ログインの削除により、既存のゲームアプリに依存関係の問題が発生します。既存のゲームアプリを games v1 SDK から games v2 SDK に移行すると、Google ログインの削除によって発生した依存関係の問題が解決します。

このドキュメントでは、ゲーム アプリケーションとさまざまな SDK 間のインタラクションを説明します。このドキュメントでは、アプリケーションの機能と、Play Games サービス games v1 SDK と games v2 SDK の機能を比較しています。

SDK のインタラクション

次の図は、Android のゲーム アプリケーション、Google モバイル サービス（GMS）コア、Play Games サービス、サードパーティ（3P）ゲーム サーバー間のインタラクションを示しています。アプリが認証とゲーム機能に Google のサービスを使用し、別のサードパーティ システムともやり取りする方法が強調されます。

games v2（現行）

Android のゲーム アプリケーション、GMS Core、Play Games サービス、サードパーティ（3P）ゲームサーバーの間のインタラクション。
Android のゲーム アプリケーション、GMS Core、Play Games 開発者サービス、サードパーティ（3P）ゲーム サーバーの間のインタラクション。（クリックして拡大）

games v1（以前のバージョン）

Android のゲーム アプリケーション、GMS Core、Play Games サービス、サードパーティ（3P）ゲームサーバーの間のインタラクション。
Android のゲーム アプリケーション、GMS Core、Play Games 開発者サービス、サードパーティ（3P）ゲーム サーバー間のインタラクション。（クリックして拡大）

コンポーネントと SDK の概要は次のとおりです。

  • ゲーム アプリケーション。
    • これは、Android 搭載デバイスで実行されているユーザーのゲーム アプリケーションを表します。
    • 主に次の 2 つのコンポーネントがあります。
      • games v1 または games v2 SDK。Play Games サービスとのやり取りを担当するクライアントサイド SDK。
      • Auth SDK。Google Play 開発者サービス Auth SDK は、games v1 のユーザー認証フローと認可フローを処理します。
    • どちらの SDK も AIDL（Android インターフェース定義言語）を使用して通信し、異なるプロセスまたはサービス間の通信パターンを示します。
  • GMS Core（Google Play 開発者サービス）
    • これは Android の Google 独自のレイヤです。
    • ゲーム アプリケーションは、次の 2 つの GMS Core モジュールを使用します。
      • ゲーム モジュール: リーダーボード、実績、ゲーム状態の管理など、ゲーム固有の機能を提供します。
      • 認証モジュール。ユーザー認証と認可オペレーションを処理します。
    • ゲーム アプリケーションの Games SDK と Auth SDK は、プロセス間通信（IPC）を示す AIDL インターフェースを使用して、対応するモジュールと通信します。

  • Play Games サービス ゲートウェイ。
    • GMS Core と Play Games サービス サーバーの間の通信を仲介する論理ゲートウェイ。
    • サーバー通信の API リクエスト、データ変換、認証を処理します。
  • Play Games サービス サーバー。
    • ゲームデータの保存、ユーザー アカウントの管理、マルチプレーヤー機能の提供を担当する Play Games サービス バックエンド サービスを表します。
  • サードパーティのゲーム ゲートウェイ。
    • ゲーム アプリケーションがサードパーティ（3P）アプリケーションの要件を満たしている場合、クライアント ライブラリはサードパーティのゲームサーバー経由で Play Games サービス サーバーと通信します。
    • アプリケーションが別のサービス プロバイダで認証できることを意味します。
  • サードパーティのゲーム サーバー。
    • ゲーム アプリケーションがやり取りできるオプションの外部サーバーを表現します。これは、カスタム機能やデータ管理のために使用されます。
    • アプリケーションとの通信は、サードパーティのゲーム ゲートウェイを介して行われます。

機能の比較

次の表に、games v1 SDK と games v2 SDK の機能の比較を示します。


機能
games v1 SDK
games v2 SDK

認証
play-services-auth との統合が必要です。
簡素化され、合理化されました。play-services-auth は不要です。

認可
成功、失敗、再試行の追加コード。
SDK によって管理

サーバー アクセス トークン
GoogleSigninClient を使用して追加の OAuth 2.0 スコープをリクエストできます。

ログイン時のエラー処理用の追加コード。
追加のスコープは許可されません。

serverAuthcode を使用した成功失敗コールバックを含む追加コード。

ログイン プロセス
GoogleSigninClient を使用します。

自動ログインとエラー処理のボイラープレート コードを処理するための追加コード。
GamesSignInClient を使用します。

SDK は、ボイラープレート コード、自動ログイン、エラー処理を処理します。

ようこそポップアップ
追加のコードが必要です。
デベロッパーは、その配置とタイミングを制御できます。
追加コードは不要です すべての PGS V2 構成ゲームでユーザー インターフェースが統一されます。 。

依存関係
play-services-auth が必要。
play-services-auth に個別の依存関係はありません。
ログアウト
GoogleSignInClient.signOut を使用します。
Sign-out API はサポートされていません。

複数の Play Games サービス アカウントとゲームごとの設定
アカウントの選択と管理はできません。
ゲームごとに Play Games 開発者サービスのアカウントを管理できます。 これにより、各ゲームで使用するアカウントを選択できます。