gpg::GameServices::Builder

#include <builder.h>

用於建立及設定 GameServices 類別的執行個體。

摘要

建構函式和解構函式
Builder()
~Builder()

公開類型
OnAuthActionFinishedCallback typedef
std::function< void(AuthOperation, AuthStatus)>
完成的回呼類型可以提供給 SDK。
OnAuthActionStartedCallback typedef
std::function< void(AuthOperation)>
可提供給 SDK 的驗證動作啟動回呼類型。
OnLogCallback typedef
std::function< void(LogLevel, const std::string &)>
可提供給 SDK 的記錄回呼類型。
OnMultiplayerInvitationEventCallback typedef
std::function< void(MultiplayerEvent, std::string, MultiplayerInvitation)>
可提供給 SDK 的多人遊戲邀請回呼類型。
OnTurnBasedMatchEventCallback typedef
std::function< void(MultiplayerEvent event, std::string, TurnBasedMatch)>
可提供給 SDK 的回合製多人遊戲事件回呼類型。

公用函式
AddOauthScope(const std::string & scope)
要求的範圍超過 Play 遊戲規定的必要範圍。
Create(const PlatformConfiguration & platform)
std::unique_ptr< GameServices >
接受平台設定並嘗試傳回新例項化的 GameServices 物件。
EnableSnapshots()
啟用快照。
SetDefaultOnLog(LogLevel min_level)
指定記錄應在指定記錄層級使用 DEFAULT_ON_LOG_CALLBACK。
SetLogging(OnLogCallback callback, LogLevel min_level) 已淘汰。 偏好 SetOnLog 和 SetDefaultOnLog。註冊用於執行記錄的回呼。min_level 指定呼叫回呼的最低記錄層級。可能的等級包括：VERBOSE、INFO、WARNING 和 ERROR。
SetLogging(OnLogCallback callback) 已淘汰。 偏好 SetOnLog 和 SetDefaultOnLog。註冊用於執行記錄的回呼，與使用 INFO 的 LogLevel 呼叫 SetLogging(OnLogCallback, LogLevel) 相同。
SetOnAuthActionFinished(OnAuthActionFinishedCallback callback)
註冊授權完成時要呼叫的回呼。
SetOnAuthActionStarted(OnAuthActionStartedCallback callback)
註冊授權開始時要呼叫的回呼。
SetOnLog(OnLogCallback callback, LogLevel min_level)
註冊會用來執行記錄的回呼。
SetOnLog(OnLogCallback callback)
註冊會用來執行記錄的回呼。
SetOnMultiplayerInvitationEvent(OnMultiplayerInvitationEventCallback callback)
註冊當多人遊戲邀請的事件發生時，要呼叫的回呼。
SetOnTurnBasedMatchEvent(OnTurnBasedMatchEventCallback callback)
註冊回合製多人對戰事件發生事件時要呼叫的回呼。
SetShowConnectingPopup(bool show_popup)
設定是否在登入流程開始時自動顯示「連線中」彈出式視窗。

公開類型

OnAuthActionFinishedCallback

std::function< void(AuthOperation, AuthStatus)> OnAuthActionFinishedCallback

完成的回呼類型可以提供給 SDK。

OnAuthActionStartedCallback

std::function< void(AuthOperation)> OnAuthActionStartedCallback

可提供給 SDK 的驗證動作啟動回呼類型。

OnLogCallback

std::function< void(LogLevel, const std::string &)> OnLogCallback

可提供給 SDK 的記錄回呼類型。

OnMultiplayerInvitationEventCallback

std::function< void(MultiplayerEvent, std::string, MultiplayerInvitation)> OnMultiplayerInvitationEventCallback

可提供給 SDK 的多人遊戲邀請回呼類型。

Valid() 只會針對 UPDATED 事件的 MultiplayerInvitation 傳回 true。

OnTurnBasedMatchEventCallback

std::function< void(MultiplayerEvent event, std::string, TurnBasedMatch)> OnTurnBasedMatchEventCallback

可提供給 SDK 的回合製多人遊戲事件回呼類型。

Valid() 只會針對 UPDATED 事件的 TurnBasedMatch 參數傳回 true。

公用函式

AddOauthScope

Builder & AddOauthScope(
  const std::string & scope
)

要求的範圍超過 Play 遊戲規定的必要範圍。

如要進一步瞭解授權範圍，請前往 https://developers.google.com/+/api/oauth#scopes。

Builder

 Builder()

建立

std::unique_ptr< GameServices > Create(
  const PlatformConfiguration & platform
)

接受平台設定並嘗試傳回新例項化的 GameServices 物件。

如果指定的 PlatformConfiguration (即 !platform.Valid()) 無效，會傳回 nullptr，如果其他 GameServices 物件已執行個體化，也可能會傳回 nullptr。

詳情請參閱 IosPlatformConfiguration、AndroidPlatformConfiguration 和 PlatformConfiguration 的說明文件：https://developers.google.com/games/services/cpp/api/platform__configuration_8h

EnableSnapshots

Builder & EnableSnapshots()

啟用快照。

這相當於 AddOauthScope(kSnapshotScope)。詳情請參閱 SnapshotManager。

SetDefaultOnLog

Builder & SetDefaultOnLog(
  LogLevel min_level
)

指定記錄應在指定記錄層級使用 DEFAULT_ON_LOG_CALLBACK。

min_level 指定叫用預設回呼的最低記錄層級。可能的等級包括：VERBOSE、INFO、WARNING 和 ERROR。這相當於呼叫 SetOnLog(OnLogCallback, LogLevel)，並將 OnLogCallback 設為 DEFAULT_ON_LOG_CALLBACK，以及 min_level 的 LogLevel。

SetLogging

Builder & SetLogging(
  OnLogCallback callback,
  LogLevel min_level
)

已淘汰。 偏好 SetOnLog 和 SetDefaultOnLog。註冊用於執行記錄的回呼。min_level 指定呼叫回呼的最低記錄層級。可能的等級包括：VERBOSE、INFO、WARNING 和 ERROR。

SetLogging

Builder & SetLogging(
  OnLogCallback callback
)

已淘汰。 偏好 SetOnLog 和 SetDefaultOnLog。註冊用於執行記錄的回呼，與使用 INFO 的 LogLevel 呼叫 SetLogging(OnLogCallback, LogLevel) 相同。

SetOnAuthActionFinished

Builder & SetOnAuthActionFinished(
  OnAuthActionFinishedCallback callback
)

註冊授權完成時要呼叫的回呼。

SetOnAuthActionStarted

Builder & SetOnAuthActionStarted(
  OnAuthActionStartedCallback callback
)

註冊授權開始時要呼叫的回呼。

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback,
  LogLevel min_level
)

註冊會用來執行記錄的回呼。

min_level 指定叫用回呼的最低記錄層級。可能的等級包括：VERBOSE、INFO、WARNING 和 ERROR。

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback
)

註冊會用來執行記錄的回呼。

這相當於使用 INFO 的 LogLevel 呼叫 SetOnLog(OnLogCallback, LogLevel)。

SetOnMultiplayerInvitationEvent

Builder & SetOnMultiplayerInvitationEvent(
  OnMultiplayerInvitationEventCallback callback
)

註冊當多人遊戲邀請的事件發生時，要呼叫的回呼。

SetOnTurnBasedMatchEvent

Builder & SetOnTurnBasedMatchEvent(
  OnTurnBasedMatchEventCallback callback
)

註冊回合製多人對戰事件發生事件時要呼叫的回呼。

SetShowConnectingPopup

Builder & SetShowConnectingPopup(
  bool show_popup
)

設定是否在登入流程開始時自動顯示「連線中」彈出式視窗。

預設為啟用。

~建構工具

 ~Builder()