ログイン

Play ゲームサービスのログインを使用すると、プレーヤーのゲーム ID を取得できます。これは、Android プレーヤー用のプラットフォーム レベルのゲームに固有の ID です。この ID により、ゲームとプレーヤーとの関係を構築できます。プレーヤーは、代替の一元管理システムよりも、この ID によるログインを進んで行います。

また、ログインにより、クラウド保存システムの鍵として使用できる強力で一貫した ID を使用できます。クラウド保存は高く評価されます。これにより、プレーヤーは次のことを行えます。

  • デバイスを変更、リセットした場合に、中断したところから再開する
  • 複数のデバイス（別のスマートフォンや Chromebook など）でゲームをプレイする
  • ゲームをアンインストールして後で再インストールする

Play ゲームサービス ID は、独自のクラウド保存ソリューションの鍵として使用できます。または、無料の保存済みゲームサービスを使用することもできます。

Play Games サービス（PGS）は、自動ログインをサポートしています。 プレーヤーによるログインのほか、ワンクリックでの手動ログインも可能です。この ドキュメントをご覧ください。

推奨されるログインフロー

プレーヤーがゲームに正常にログインできるようにするには、次のログインフローを使用します。

  1. ゲームの起動シーケンス中に自動ログインを試す 自動的にログインします。
  2. 自動ログインが機能せず、ユーザーのデバイスがオンラインの場合は、手動ログインを試します。
  3. 手動ログインが拒否された場合は、ユーザーの選択を記憶し、ログインを もう一度手動ログインを試しますが、引き続き起動時の自動ログインを試します。

また、ユーザーが Google Play Console で 簡単に見つけられる専用のボタンを用意しておく必要があります。

自動ログイン

自動ログインを使用すると、ユーザーはスムーズにゲームにログインできます。 自動！ゲームがユーザーにログインと自動ログインをリクエストする場合 設定が有効になっている場合（Google Play Games アプリで）有効な場合、ユーザーの PGS を受け取ります。 PGS のログイン エクスペリエンスが表示されます。

自動ログインは、ユーザーが制御できる設定です。ユーザーは、すべてのゲームに自動的にログインすることを選択できます。または、毎回ログインを求める画面が表示されるように選択することもできます。

自動ログイン

手動ログイン

ユーザーがゲームに自動的にログインしない場合は、ユーザーにログインを求めることができます できます。上部に表示されたダイアログ ボックスからワンクリックでログイン 説明します

手動ログイン

正しいログイン操作のために PGS ポップアップを許可する

PGS を使用するユーザーは、ログインしていることを知らせる必要があります。そのためにはまず 設定することもできます。

ログイン エクスペリエンスを表示するには、 setViewForPopups() ゲーム起動時に GamesClient クラスのメソッドを呼び出します。これは 適切なユーザーエクスペリエンスが 可能になります

OAuth スコープと PGS

PGS は OAuth システムを利用して、ユーザーが以下の操作を行えるようにします。 ゲームにアクセス権を付与する必要があります。 OAuth スコープは、 デベロッパーがリクエストできます。これらの権限が付与されると、ゲームで特定のメソッドの呼び出しが可能になります。 ユーザーの代わりに API を作成し、ユーザーの特定の部分へのアクセス権を Google アカウント。

PGS にはゲームに固有のスコープ（games-lite）があり、別のスコープに依存しています （drive.appdata）- ゲームが保存済みゲーム機能を使用している場合。保存済みゲーム機能では、ユーザーの Google ドライブ アカウントにアクセスできます。このアカウントには、ゲームのデータが保存されています。

優れたゲーム エクスペリエンスを作り出すために必要な任意のスコープをゲームでリクエストできる 提供しますゲームでは必要なすべてのスコープを 1 つのバンドルでリクエストできます。 Google アカウントへのアクセス リクエストの数を制限する。ただし、 大きな欠点があります。PGS 固有のスコープよりも多くのスコープをリクエストする場合は、 成功することはできません。自動ログインは、 プレーヤー数を記録します。

おすすめの方法は、増分スコープ リクエストを使用することです。ゲームでは、 最初のリクエストの PGS 専用のスコープが最初に存在し、他のスコープがリクエストされる より的確なタイミングで表示されます。

OAuth アクセスは、スコープごとに異なる画面を使用して付与されます。これにより、 ユーザーがどのスコープにアクセス権を付与するかをきめ細かく決められます。方法 PGS スコープのみを使用した自動ログイン。ユーザーは任意の ログインの手間を軽減する OAuth プロンプト

複数のログイン方法のサポート

PGS は Android プレーヤーにゲーム ID を提供しますが、必ずしもそうする必要はありません ユーザーに関連付けられている唯一の ID になります。プレーヤーのログインには PGS という ソーシャル ネットワーク ID と独自のゲーム内 ID システムを同時に使用できます。各 独自の価値をプレーヤーに提供します 優れたエクスペリエンスを構築しています

バックエンド統合のためにプレーヤー ID を安全に取得して検証する

サーバーが、ログイン プレーヤーの権限を使用して REST API を介して Play ゲームサービス サーバーと直接通信できるように、サーバー認証コードをリクエストできます。これにより、プレーヤーの ID、プロフィール、その他の情報（例: 承認されている場合の友だちリスト）に直接アクセスできます。プレーヤー ID、友だち ID、その他の関連データをバックエンドに保存する場合は、このメソッドを使用して、これらのフィールドがデバイス側で操作される可能性を排除する必要があります。

また、一部の古いゲームやプレーヤーについては、あるプレーヤーが Android SDK でプレーヤー ID を返す際に、他のプレーヤーが同じプレーヤーを表示した場合と同じ ID にならない可能性があります。この状態は、友だちリストを使用している場合に特に発生する可能性が高くなります。ただし、REST API 内で返される player_id は常に整合性があり、他のプレーヤーに表示される ID です。

詳細については、オフライン アクセスと REST API のドキュメントをご覧ください。

クライアントの実装

Android でログイン サポートを実装する方法については、Android ゲームでのログインをご覧ください。