Google Play Games サービス、ゲーム v1 SDK は、サポートが終了し、2025 年に Google Play 開発者サービス Auth SDK（com.google.android.gms:play-services-auth）から削除される Google ログイン for Android に依存しています。新しいゲームアプリは、2025 年までゲーム v1 を使用できます。Google ログインを削除すると、既存のゲームアプリで依存関係の問題が発生します。既存のゲームアプリを games v1 SDK から games v2 SDK に移行すると、Google ログインの削除によって発生した依存関係の問題が解決されます。
このドキュメントでは、ゲーム アプリケーションとさまざまな SDK の間のインタラクションについて説明します。また、このドキュメントでは、アプリの機能と Play ゲームサービス ゲーム v1 およびゲーム v2 SDK の機能を比較します。
SDK のインタラクション
次の図は、Android のゲーム アプリケーション、Google モバイル サービス（GMS）コア、Play Games サービス、サードパーティ（3P）ゲーム サーバー間のインタラクションを示しています。この図は、アプリが認証とゲーム機能に Google のサービスを使用しながら、別のサードパーティ システムとも連携していることを示しています。
games v2（現在）
games v1（以前のバージョン）
Android、GMS Core、Play Games サービス、サードパーティ（3P）ゲームサーバー間のゲーム アプリケーションのやり取り。コンポーネントと SDK の概要は次のとおりです。
- ゲーム アプリケーション。
- これは、Android 搭載デバイスで実行されているユーザーのゲーム アプリケーションを表します。
- これには、次の 2 つの主要コンポーネントが含まれています。
- games v1 または games v2 SDK。Play ゲームサービスとのやり取りを担当するクライアントサイド SDK。
- Auth SDK。Google Play 開発者サービス Auth SDK は、ゲーム v1 でのユーザー認証と認可フローの処理を担当します。
- どちらの SDK も AIDL（Android インターフェース定義言語）を使用して通信します。これは、さまざまなプロセスやサービス間の通信パターンを示しています。
- GMS Core は Google Play 開発者サービスとも呼ばれます。
- これは Android の Google 独自のレイヤです。
- ゲーム アプリケーションは、次の 2 つの GMS Core モジュールを使用します。
- ゲーム モジュールは、リーダーボード、実績、ゲームの状態管理などのゲーム固有の機能を提供します。
- Auth モジュール。ユーザー認証と認可のオペレーションを処理します。
- ゲーム アプリケーションの Games SDK と Auth SDK は、 AIDL インターフェースを使用して対応するモジュールと通信します。これはプロセス間通信（IPC）を示しています。
- Play Games サービスのゲートウェイ。
- GMS Core と Play Games Services サーバー間の通信を仲介する論理ゲートウェイ。
- サーバー通信の API リクエスト、データ変換、認証を処理します。
- Play ゲームサービス サーバー。
- ゲームデータの保存、ユーザー アカウントの管理、マルチプレーヤー機能の実現を担当する Play ゲームサービス バックエンド サービスを表します。
- サードパーティ製ゲームのゲートウェイ。
- ゲームアプリがサードパーティ（3P）アプリとして認定されている場合、クライアント ライブラリはサードパーティ ゲームサーバーを介して Play ゲームサービス サーバーと通信します。
- アプリケーションが別のサービス プロバイダで認証できることも意味します。
- サードパーティのゲームサーバー。
- ゲーム アプリケーションがやり取りできるオプションの外部サーバーを表します。カスタム機能やデータ管理に使用される可能性があります。
- アプリケーションとの通信は、サードパーティ製ゲームのゲートウェイを介して行われます。
機能の比較
次の表は、ゲーム v1 SDK とゲーム v2 SDK の機能の比較を示しています。
特徴 |
games v1 SDK |
games v2 SDK |
|---|---|---|
認証 |
play-services-auth との統合が必要です。 |
簡素化され、合理化されています。 play-services-auth は不要です。 |
承認 |
成功、失敗、再試行の追加コード。 |
SDK によって管理される |
サーバー アクセス トークン |
GoogleSigninClient を使用して、追加の
OAuth 2.0 スコープをリクエストできます。ログイン時のエラー処理用の追加コード。 |
Play ゲームサービス ウェブ API へのサーバーサイド アクセスをリクエストする際に、 GamesSignInClient を使用して 3 つの基本的な OAuth 2.0 ID スコープをリクエストできます。詳しくは、 Play ゲームサービスに対するサーバーサイドのアクセスと サーバー認証コードを取得するをご覧ください。 |
ログイン プロセス |
GoogleSigninClient を使用します。自動ログインとエラー処理のボイラープレート コードの処理のための追加コード。 |
GamesSignInClient を使用します。SDK は、ボイラープレート コード、自動ログイン、エラー処理を処理します。 |
Welcome Popup |
追加のコードが必要です。 デベロッパーは、その配置とタイミングを制御できます。 |
追加のコードは必要ありません。Google Play Games サービス v2 の SDK で設定されたすべてのゲームで一貫したユーザー インターフェース。 |
依存関係 |
play-services-auth が必要。 |
Games モジュールは、認可と認証を処理します。追加の依存関係を追加する必要はありません。 |
| ログアウト |
GoogleSignInClient.signOut を使用します。 |
ログアウト API はサポートされていません。 |
複数の Play ゲームサービス アカウントとゲームごとの設定 |
ゲーム内でアカウント管理が可能です。 |
ユーザーはモバイル デバイスの設定で Play ゲームサービス プロフィールを変更できます。詳しくは、 モバイルで Play Games プロフィールを切り替える方法をご覧ください。 |