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 日志级别调用 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 的多人游戏邀请回调的类型。

仅在 UPDATED 事件中，Valid() 才返回 MultiplayerInvitation 的 true 值。

OnTurnBasedMatchEventCallback

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

可提供给 SDK 的回合制多人游戏事件回调的类型。

仅在 UPDATED 事件中，Valid() 才返回 TurnBasedMatch 参数的 true 值。

公共函数

AddOauthScope

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

需要请求的超出必需 Play 游戏范围的范围。

授权范围的详细信息，请访问 https://developers.google.com/+/api/oauth#scopes。

Builder

 Builder()

Create

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。这等效于使用设置为 DEFAULT_ON_LOG_CALLBACK 的 OnLogCallback 和 min_level 日志级别调用 SetOnLog(OnLogCallback, 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 日志级别调用 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 日志级别调用 SetOnLog(OnLogCallback, LogLevel)。

SetOnMultiplayerInvitationEvent

Builder & SetOnMultiplayerInvitationEvent(
  OnMultiplayerInvitationEventCallback callback
)

注册一个回调，以便在多人游戏邀请发生事件时调用。

SetOnTurnBasedMatchEvent

Builder & SetOnTurnBasedMatchEvent(
  OnTurnBasedMatchEventCallback callback
)

注册一个回调，以便在回合制多人游戏匹配发生事件时调用。

SetShowConnectingPopup

Builder & SetShowConnectingPopup(
  bool show_popup
)

设置在登录流程开始时是否应自动显示“正在连接”弹出窗口。

默认情况下启用此功能。

~Builder

 ~Builder()