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（現行）
games v1（以前のバージョン）
コンポーネントと 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 開発者サービスのアカウントを管理できます。 これにより、各ゲームで使用するアカウントを選択できます。 |