gpg::PlayerManager

#include <player_manager.h>

获取和设置各种与玩家相关的数据。

摘要

公共类型
FetchCallback typedef
std::function< void(const FetchResponse &)>
定义接收 FetchResponse 的回调类型。
FetchListCallback typedef
std::function< void(const FetchListResponse &)>
定义接收 FetchListResponse 的回调类型。
FetchSelfCallback typedef
std::function< void(const FetchSelfResponse &)>
定义接收 FetchSelfResponse 的回调类型。

公共函数
Fetch(const std::string & player_id, FetchCallback callback)
void
异步加载特定播放器的所有数据。
Fetch(DataSource data_source, const std::string & player_id, FetchCallback callback)
void
异步加载特定播放器的所有数据。
FetchBlocking(const std::string & player_id)
同步加载特定播放器的所有数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, const std::string & player_id)
同步加载特定播放器的所有数据，直接返回 FetchResponse。
FetchBlocking(Timeout timeout, const std::string & player_id)
同步加载特定播放器的所有数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & player_id)
同步加载特定播放器的所有数据，直接返回 FetchResponse。
FetchConnected(DataSource data_source, FetchListCallback callback)
void
<ph type="x-smartling-placeholder"></ph> 已弃用。
异步加载已连接到当前游戏且已登录玩家有权了解的所有玩家。
FetchConnected(FetchListCallback callback)
void
<ph type="x-smartling-placeholder"></ph> 已弃用。
使用 CACHE_OR_NETWORK 的默认数据源的 FetchConnected 过载。
FetchConnectedBlocking(DataSource data_Source, Timeout timeout) <ph type="x-smartling-placeholder"></ph> 已弃用。
FetchConnected 的阻止版本。
FetchConnectedBlocking(DataSource data_source) <ph type="x-smartling-placeholder"></ph> 已弃用。
使 FetchConnectedBlocking 过载，默认超时时间为 10 年。
FetchConnectedBlocking(Timeout timeout) <ph type="x-smartling-placeholder"></ph> 已弃用。
使用 CACHE_OR_NETWORK 的默认数据源的 FetchConnectedBlocking 过载。
FetchConnectedBlocking() <ph type="x-smartling-placeholder"></ph> 已弃用。
使用 FetchConnectedBlocking 的过载，该数据源使用默认数据源 CACHE_OR_NETWORK，默认超时时间为 10 年。
FetchInvitable(DataSource data_source, FetchListCallback callback)
void
<ph type="x-smartling-placeholder"></ph> 已弃用。
异步加载本地玩家的圈子中的所有玩家（并且可以接收来自本地玩家的邀请）。
FetchInvitable(FetchListCallback callback)
void
<ph type="x-smartling-placeholder"></ph> 已弃用。
使用 CACHE_OR_NETWORK 的默认数据源的 FetchInvitable 过载。
FetchInvitableBlocking(DataSource data_source, Timeout timeout) <ph type="x-smartling-placeholder"></ph> 已弃用。
FetchInvitable 的阻止版本。
FetchInvitableBlocking(DataSource data_source) <ph type="x-smartling-placeholder"></ph> 已弃用。
FetchInvitableBlocking 过载，默认超时时间为 10 年。
FetchInvitableBlocking(Timeout timeout) <ph type="x-smartling-placeholder"></ph> 已弃用。
使用 CACHE_OR_NETWORK 的默认数据源的 FetchInvitableBlocking 过载。
FetchInvitableBlocking() <ph type="x-smartling-placeholder"></ph> 已弃用。
FetchInvitableBlocking 过载，其使用默认数据源 CACHE_OR_NETWORK ，默认超时时间为 10 年。
FetchRecentlyPlayed(DataSource data_source, FetchListCallback callback)
void
异步加载最近播放的所有玩家。
FetchRecentlyPlayed(FetchListCallback callback)
void
使用 CACHE_OR_NETWORK 的默认数据源的 FetchRecentlyPlayed 过载。
FetchRecentlyPlayedBlocking(DataSource data_source, Timeout timeout)
FetchRecentlyPlayed 的阻止版本。
FetchRecentlyPlayedBlocking(DataSource data_source)
FetchRecentlyPlayedBlocking 过载，默认超时时间为 10 年。
FetchRecentlyPlayedBlocking(Timeout timeout)
使用 CACHE_OR_NETWORK 的默认数据源的 FetchRecentlyPlayedBlocking 过载。
FetchRecentlyPlayedBlocking()
使 FetchRecentlyPlayedBlocking 过载，默认数据源为 CACHE_OR_NETWORK，默认超时时间为 10 年。
FetchSelf(FetchSelfCallback callback)
void
异步加载当前已登录的所有玩家的所有数据。
FetchSelf(DataSource data_source, FetchSelfCallback callback)
void
异步加载当前已登录的所有玩家的所有数据。
FetchSelfBlocking()
同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。
FetchSelfBlocking(DataSource data_source)
同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。
FetchSelfBlocking(Timeout timeout)
同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。
FetchSelfBlocking(DataSource data_source, Timeout timeout)
同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。

结构体
gpg::PlayerManager::FetchListResponse

包含玩家矢量的响应。
gpg::PlayerManager::FetchResponse

特定 Player 的 data 和 ResponseStatus。
gpg::PlayerManager::FetchSelfResponse

保存所有玩家数据以及响应状态。

公共类型

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。如果未指定超时值，则此函数调用等同于使用您指定的 data_source 值和 10 年超时值来调用 FetchResponse FetchBlocking(DataSource data_source, Timeout time)。

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & player_id
)

同步加载特定播放器的所有数据，直接返回 FetchResponse。

将超时指定为任意毫秒数。未指定 data_source 后，此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout time)，并将 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 重新请求指定的玩家来检索关卡信息。<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchConnected

void FetchConnected(
  FetchListCallback callback
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchConnected 过载。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  DataSource data_Source,
  Timeout timeout
)

FetchConnected 的阻止版本。

允许调用方指定超时（以毫秒为单位）。指定的时间过后，该函数会返回 ERROR_TIMEOUT。请注意，在 iOS 上，无法从界面线程调用此阻塞版本，因为提供数据的底层 Plus 服务必须在界面线程上运行操作。<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  DataSource data_source
)

使 FetchConnectedBlocking 过载，默认超时时间为 10 年。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  Timeout timeout
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchConnectedBlocking 过载。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking()

使用 FetchConnectedBlocking 的过载，该数据源使用默认数据源 CACHE_OR_NETWORK，默认超时时间为 10 年。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitable

void FetchInvitable(
  DataSource data_source,
  FetchListCallback callback
)

异步加载本地玩家的圈子中的所有玩家（并且可以接收来自本地玩家的邀请）。

请注意，如果不可避免的玩家未连接到当前游戏，他们可能不会收到任何表明自己已被邀请的通知。

在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。

请注意，此函数可能会返回Player对象，而Player.HasLevelInfo返回“false”。在这种情况下，用户可以通过Fetch API 重新请求指定的玩家来检索关卡信息。<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitable

void FetchInvitable(
  FetchListCallback callback
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchInvitable 过载。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  DataSource data_source,
  Timeout timeout
)

FetchInvitable 的阻止版本。

允许调用方指定超时（以毫秒为单位）。指定的时间过后，该函数会返回 ERROR_TIMEOUT。请注意，在 iOS 上，无法从界面线程调用此阻塞版本，因为提供数据的底层 Plus 服务必须在界面线程上运行操作。<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  DataSource data_source
)

FetchInvitableBlocking 过载，默认超时时间为 10 年。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  Timeout timeout
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchInvitableBlocking 过载。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking()

FetchInvitableBlocking 过载，其使用默认数据源 CACHE_OR_NETWORK ，默认超时时间为 10 年。

<ph type="x-smartling-placeholder"></ph> 已弃用。

FetchRecentlyPlayed

void FetchRecentlyPlayed(
  DataSource data_source,
  FetchListCallback callback
)

异步加载最近播放的所有玩家。

在操作完成时调用提供的 FetchCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。

FetchRecentlyPlayed

void FetchRecentlyPlayed(
  FetchListCallback callback
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchRecentlyPlayed 过载。

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  DataSource data_source,
  Timeout timeout
)

FetchRecentlyPlayed 的阻止版本。

允许调用方指定超时（以毫秒为单位）。指定的时间过后，该函数会返回 ERROR_TIMEOUT。

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  DataSource data_source
)

FetchRecentlyPlayedBlocking 过载，默认超时时间为 10 年。

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  Timeout timeout
)

使用 CACHE_OR_NETWORK 的默认数据源的 FetchRecentlyPlayedBlocking 过载。

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, TimeoutTimeout)，将 data_source 指定为 CACHE_OR_NETWORK，将超时指定为 10 年。

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  DataSource data_source
)

同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定超时，则系统会使用您指定的 data_source 值并将超时指定为 10 年，调用此函数等同于调用 FetchSelfResponse FetchSelfBLOCK(DataSource data_source, Timeout time)。

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  Timeout timeout
)

同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。

将超时指定为任意毫秒数。如果未指定 data_source，则此函数调用等同于调用 FetchSelfResponse FetchSelfBlocking(DataSource data_source, TimeoutTimeout)，将 data_source 指定为 CACHE_OR_NETWORK，超时值包含你指定的值。

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  DataSource data_source,
  Timeout timeout
)

同步加载当前已登录的所有玩家的所有数据，直接返回 FetchSelfResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将超时指定为任意毫秒数。