gpg::GameServices

Google Play Games を操作するための出発点です。

概要

ゲームサービスのライフサイクル

GameServices クラスのインスタンスは GameServices::Builder を介して作成されます。作成されたインスタンスは、最初はゲームサービスにログインしていません（つまり、IsAuthorized() は false を返します）。サイレント ログインの試行はバックグラウンドで開始されますが、前回のセッションの終了時にユーザーがログインした場合は成功する可能性があります。このサイレント ログインの試行が完了するまでは、ユーザー認証 UI（ログイン ボタンやログアウト ボタンなど）をすべて無効にするか非表示にする必要があります。

このサイレント ログインの試行が完了すると、（GameServices::Builder::SetOnAuthActionFinished に登録されている）GameServices インスタンスの OnAuthActionFinished コールバックが通知されます。コールバック引数がログイン試行の成功を反映している場合、そのインスタンスはゲーム サービスに接続されていると見なされ（つまり、IsAuthorized() が true を返すため）、ログアウト UI を有効にする必要があります。コールバック引数がログイン試行の失敗を反映している場合は、ログイン UI を有効にする必要があります。

SignOut() メソッドによる明示的なログアウトは、ユーザーのリクエストがある場合にのみ呼び出す必要があります。ログアウト状態への移行をリクエストします。この遷移の完了は、OnAuthActionFinished コールバックの呼び出しによって示されます。このコールバックが呼び出されるまで、他の GameServices API（StartAuthorizationUI() など）は呼び出さないでください。

GameServices インスタンスが破壊されると、データの損失を避けるため、保留中のオペレーションがなくなるまでブロックされます。この破棄時のブロック動作が望ましくない場合は、Flush() を発行し、GameServices インスタンスは Flush() が完了するまで存続させる必要があります。

バージョン 4.0 より前の Android で GameServices を正しく機能させるには、所有する Activity がライフサイクル コールバックを呼び出す必要があります。AndroidSupport をご覧ください。

公開タイプ

std::function< void(FlushStatus)> FlushCallback

パブリック関数

AchievementManager & Achievements()

const AchievementManager & Achievements() const 

EventManager & Events()

const EventManager & Events() const 

void Flush(
  FlushCallback callback
)

FlushStatus FlushBlocking()

FlushStatus FlushBlocking(
  Timeout timeout
)

 GameServices()=delete

bool IsAuthorized()

LeaderboardManager & Leaderboards()

const LeaderboardManager & Leaderboards() const 

PlayerManager & Players()

const PlayerManager & Players() const 

RealTimeMultiplayerManager & RealTimeMultiplayer()

const RealTimeMultiplayerManager & RealTimeMultiplayer() const 

void SignOut()

SnapshotManager & Snapshots()

const SnapshotManager & Snapshots() const 

void StartAuthorizationUI()

StatsManager & Stats()

const StatsManager & Stats() const 

TurnBasedMultiplayerManager & TurnBasedMultiplayer()

const TurnBasedMultiplayerManager & TurnBasedMultiplayer() const 

VideoManager & Video()

const VideoManager & Video() const 

 ~GameServices()