gpg:: PlayerManager
#include <player_manager.h>
获取和设置各种与玩家相关的数据。
摘要
公共类型 |
|
---|---|
FetchCallback
|
typedefstd::function< void(const FetchResponse &)>
定义接收 FetchResponse 的回调类型。 |
FetchListCallback
|
typedefstd::function< void(const FetchListResponse &)>
定义接收 FetchListResponse 的回调类型。 |
FetchSelfCallback
|
typedefstd::function< void(const FetchSelfResponse &)>
定义接收 FetchSelfResponse 的回调类型。 |
结构体 |
|
---|---|
gpg:: |
包含玩家向量的响应。 |
gpg:: |
|
gpg:: |
保存所有玩家数据以及响应状态。 |
公共类型
FetchCallback
std::function< void(const FetchResponse &)> FetchCallback
定义接收 FetchResponse 的回调类型。
此回调类型会提供给以下 Fetch(*)
函数。
FetchListCallback
std::function< void(const FetchListResponse &)> FetchListCallback
定义接收 FetchListResponse 的回调类型。
此回调类型会提供给以下 Fetch(*)
函数。
FetchSelfCallback
std::function< void(const FetchSelfResponse &)> FetchSelfCallback
定义接收 FetchSelfResponse 的回调类型。
此回调类型会提供给以下 FetchSelf(*)
函数。
公共函数
提取
void Fetch( const std::string & player_id, FetchCallback callback )
异步加载特定播放器的所有数据。
在操作完成时调用提供的 FetchCallback。如果未指定 data_source,则此函数调用等同于调用 Fetch(DataSource data_source, const std::string& player_id, FetchCallback callback)
,并将 data_source 指定为 CACHE_OR_NETWORK。
提取
void Fetch( DataSource data_source, const std::string & player_id, FetchCallback callback )
异步加载特定播放器的所有数据。
在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchBlocking
FetchResponse FetchBlocking( const std::string & player_id )
同步加载特定播放器的所有数据,直接返回 FetchResponse。
如果既未指定 data_source 也未指定超时,则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source, timeout timeout),将 DataSource 指定为 CACHE_OR_NETWORK 并将超时指定为 10 年。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, const std::string & player_id )
同步加载特定播放器的所有数据,直接返回 FetchResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果不指定超时,此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout),使用指定的 data_source 值,并将超时指定为 10 年。
FetchBlocking
FetchResponse FetchBlocking( Timeout timeout, const std::string & player_id )
同步加载特定播放器的所有数据,直接返回 FetchResponse。
将超时指定为任意毫秒数。如果未指定 data_source,则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout),将 data_source 指定为 CACHE_OR_NETWORK 并超时(包含您指定的值)。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, Timeout timeout, const std::string & player_id )
同步加载特定播放器的所有数据,直接返回 FetchResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将超时指定为任意毫秒数。
FetchConnected
void FetchConnected( DataSource data_source, FetchListCallback callback )
异步加载已连接到当前游戏且已登录玩家有权了解的所有玩家。
在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
请注意,此函数可能会返回 Player 对象,其中 Player.HasLevelInfo 会返回 false。在这种情况下,可以通过Fetch API 重新请求指定的玩家,从而检索关卡信息。 已弃用。
FetchConnected
void FetchConnected( FetchListCallback callback )
使用 CACHE_OR_NETWORK 默认数据源的 FetchConnected 过载。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( DataSource data_Source, Timeout timeout )
FetchConnected 的阻止版本。
允许调用方指定超时(以毫秒为单位)。在指定的时间过后,该函数会返回 ERROR_TIMEOUT
。请注意,在 iOS 上,不能从界面线程调用此阻塞版本,因为提供数据的底层 Plus 服务必须在界面线程上运行操作。
已弃用。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( DataSource data_source )
过载 FetchConnectedBlocking (使用默认 10 年超时)。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( Timeout timeout )
使用 CACHE_OR_NETWORK 默认数据源的 FetchConnectedBlocking 的重载。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking()
FetchConnectedBlocking 的过载会使用默认数据源 CACHE_OR_NETWORK 和默认超时时间(10 年)。
FetchInvitable
void FetchInvitable( DataSource data_source, FetchListCallback callback )
异步加载本地玩家圈子中的所有玩家(并且可以接收来自本地玩家的邀请)。
请注意,如果不可邀请的玩家未连接到当前游戏,他们可能不会收到任何关于自己已被邀请的通知。
在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
请注意,此函数可能会返回 Player 对象,其中 Player.HasLevelInfo 会返回 false。在这种情况下,可以通过Fetch API 重新请求指定的玩家,从而检索关卡信息。 已弃用。
FetchInvitable
void FetchInvitable( FetchListCallback callback )
FetchInvitable 的过载,它使用默认数据源 CACHE_OR_NETWORK。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( DataSource data_source, Timeout timeout )
FetchInvitable 的阻塞版本。
允许调用方指定超时(以毫秒为单位)。在指定的时间过后,该函数会返回 ERROR_TIMEOUT
。请注意,在 iOS 上,不能从界面线程调用此阻塞版本,因为提供数据的底层 Plus 服务必须在界面线程上运行操作。
已弃用。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( DataSource data_source )
FetchInvitableBlocking 的过载,它使用默认的 10 年超时时间。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( Timeout timeout )
FetchInvitableBlocking 的过载,它使用了 CACHE_OR_NETWORK 的默认数据源。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking()
FetchInvitableBlocking 的过载,它使用 CACHE_OR_NETWORK 的默认数据源和 10 年的默认超时时间。
FetchRecentlyPlayed
void FetchRecentlyPlayed( DataSource data_source, FetchListCallback callback )
异步加载所有最近玩过的玩家。
在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchRecentlyPlayed
void FetchRecentlyPlayed( FetchListCallback callback )
过载 FetchRecentlyPlayed,该操作使用默认数据源 CACHE_OR_NETWORK。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( DataSource data_source, Timeout timeout )
FetchRecentlyPlayed 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。在指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( DataSource data_source )
过载 FetchRecentlyPlayedBlocking,该机制使用默认的 10 年超时。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( Timeout timeout )
过载 FetchRecentlyPlayedBlocking 型,该组件使用默认数据源 CACHE_OR_NETWORK。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking()
对 FetchRecentlyPlayedBlocking 的重载,它使用默认数据源 CACHE_OR_NETWORK 和默认超时时间(10 年)。
FetchSelf
void FetchSelf( FetchSelfCallback callback )
异步加载所有当前已登录玩家的所有数据。
在操作完成时调用提供的 FetchSelfCallback。如果未指定 data_source,则此函数调用等同于调用 FetchSelf(DataSource data_source, FetchSelfCallback callback)
,并将 data_source 指定为 CACHE_OR_NETWORK。
FetchSelf
void FetchSelf( DataSource data_source, FetchSelfCallback callback )
异步加载所有当前已登录玩家的所有数据。
在操作完成时调用提供的 FetchSelfCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking()
同步加载所有当前已登录玩家的所有数据,直接返回 FetchSelfResponse。
如果未指定 data_source 或超时,此函数调用等同于调用 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout),将 data_source 指定为 CACHE_OR_NETWORK 并将超时指定为 10 年。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( DataSource data_source )
同步加载所有当前已登录玩家的所有数据,直接返回 FetchSelfResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果不指定超时,此函数调用等同于调用 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout)(使用指定的 data_source 值,将超时指定为 10 年)。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( Timeout timeout )
同步加载所有当前已登录玩家的所有数据,直接返回 FetchSelfResponse。
将超时指定为任意毫秒数。如果未指定 data_source,则此函数调用等同于调用 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout),将 data_source 指定为 CACHE_OR_NETWORK 并且超时包含指定的值。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( DataSource data_source, Timeout timeout )
同步加载所有当前已登录玩家的所有数据,直接返回 FetchSelfResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将超时指定为任意毫秒数。