ゲームを Google Play Games サービスと統合するには、まずプラットフォーム認証を実装します。実績、ランキング、イベントなどの他のすべての機能にアクセスするには、これが必要です。
Google Play Games Level Up のユーザー エクスペリエンスに関するガイドラインを満たすには、推奨される認証フローに準拠する必要があります。
初期化と認証
ゲームを初期化して認証するには、次の手順が必要です。
- 起動時に Play Games サービス v2 SDK を初期化して、プラットフォーム認証を実装します。詳しくは、Android ゲームのプラットフォーム認証をご覧ください。これは、実績やリーダーボードなどの Play ゲームサービス機能にアクセスするために必要な手順です。
- 認証は、ゲームの起動時にサイレント バックグラウンド プロセスとして実行されます。
既存の Play ゲームサービス ユーザーは、認証に成功するとウェルカム メッセージが表示されます。
プロフィールの作成
プレーヤーがプラットフォームを利用するには、Play ゲームサービス プロフィールが必要です。ゲームを開始したときに Play ゲームサービス プロフィールを持っていないプレーヤーもいます。これらのプレーヤーには、作成を求めるメッセージが表示されます。
Play ゲームサービス プロフィールがない状態でゲームを起動すると、デフォルトで自動トリガーによるプロフィール作成のプロンプトが自動的に表示されます。
推奨される認証フロー
Google Play Games Level Up のユーザー エクスペリエンスに関するガイドラインを満たすには、プレイヤーの継続性に関する要件に準拠していることを確認してください。プレーヤーがゲームに正常にログインできるようにするには、次の認証フローを使用します。
- ゲームの起動シーケンス中に、自動トリガーのプロフィール作成を実装します。
- 自動認証が失敗した場合や、自動認証を拒否した場合は、後で認証できるように手動ログインボタンを表示します。
プレーヤー ID
プレーヤー ID は、Play ゲームサービスのプレーヤー アカウントの識別子です。ゲームは、Play ゲームサービスの認証を使用してゲームにログインしたプレーヤーのプレーヤー ID を取得できます。ゲーム クライアントの統合、ゲームサーバーの統合、クラウド保存サービスは、この ID を使用して Play ゲームサービスからプレーヤー データに安全にアクセスできます。
ユーザーが複数のデバイスでゲームをプレイする場合、プレーヤー ID は変わりません。ただし、ゲーム間で常に不変であるとは限りません。詳しくは、次世代のプレーヤー ID をご覧ください。
OAuth スコープ
Play ゲームサービスは OAuth システムを使用して、プレーヤーがゲームからアカウントにアクセスできるようにします。Play ゲームサービスにはゲームに固有のスコープ（games-lite）があり、ゲームが保存済みゲーム機能を使用している場合は、別のスコープ（drive.appdata）に依存します。保存済みゲーム機能では、ユーザーの Google ドライブ アカウントにアクセスできます。このアカウントには、ゲームのデータが保存されています。
Play ゲームサービス v2 SDK を使用する場合、追加の OAuth スコープをリクエストできます。追加の OAuth スコープが必要な場合は、requestServerSideAccess を呼び出すことをおすすめします。詳しくは、サーバー認証コードを取得するまたはサーバー認証コードを取得するをご覧ください。
複数の認証サービス
Play ゲームサービスは Android プレーヤー用のゲーム ID を指定しますが、ユーザーに関連付けられている唯一の ID である必要はありません。Play ゲームサービス、ソーシャル ネットワーク ID、独自のゲーム内 ID システムを使用して同時にプレーヤーを認証できます。
Recall API
Recall API を使用すると、ゲームは Google サーバーにリコール トークンを保存することにより、PGS ユーザーとゲーム内アカウント間のリンクを管理できます。この機能を有効にする方法については、PGS Recall API をゲームに統合するをご覧ください。
ゲーム クライアントの統合
認証をゲーム プロジェクトに統合する場合は、次のユーザーフローを使用することをおすすめします。
ゲームの起動シーケンス中に、プロファイルの作成が起動し、ユーザーの認証または新しいアカウントの作成が試行されます。
自動認証が失敗した場合、または拒否した場合は、後で認証できるように手動ログインボタンを表示します。
認証をゲーム プロジェクトに統合する方法については、以下の中からプロジェクトのタイプに合ったドキュメントをご覧ください。
ゲームサーバーの統合
プレーヤーが認証されたことを確認したら、requestServerSideAccess を呼び出してサーバー認証コードを取得できます。このサーバー認証コードをバックエンド ゲームサーバーに渡して、Play ゲームサービスのサーバーと直接通信します。この通信により、サーバーは次のようなプレーヤーデータにアクセスできます。
- プレーヤー ID
- プロフィール
- 友だち
- ゲームの進行状況
- 実績
サーバーは、この認証コードと REST API を使用して、Play ゲームサービス サーバーと安全にやり取りします。詳しくは、Play ゲームサービスに対するサーバーサイドのアクセスをご覧ください。
ログイン リクエストの割り当て
Play ゲームサービスでのログイン リクエストには、1 日の割り当てが設定されています。詳細については、1 日の割り当ての管理をご覧ください。