gpg::LeaderboardManager

#include <leaderboard_manager.h>

获取和设置各种与排行榜相关的数据。

摘要

公共类型
FetchAllCallback	typedef std::function< void(const FetchAllResponse &)> 定义 FetchAllResponse 类型的回调。
FetchAllScoreSummariesCallback	typedef std::function< void(const FetchAllScoreSummariesResponse &)> 定义 FetchAllScoreSummariesResponse 类型的回调。
FetchCallback	typedef std::function< void(const FetchResponse &)> 定义接收 FetchResponse 的回调类型。
FetchScorePageCallback	typedef std::function< void(const FetchScorePageResponse &)> 定义 ScorePageResponse 类型的回调。
FetchScoreSummaryCallback	typedef std::function< void(const FetchScoreSummaryResponse &)> 定义 FetchScoreSummaryResponse 类型的回调。
ShowAllUICallback	typedef std::function< void(const UIStatus &)> 定义接收 UIStatus 的回调类型。
ShowUICallback	typedef std::function< void(const UIStatus &)> 定义接收 UIStatus 的回调类型。

公共函数
Fetch(const std::string & leaderboard_id, FetchCallback callback)	void 异步加载当前登录的玩家的排行榜数据。
Fetch(DataSource data_source, const std::string & leaderboard_id, FetchCallback callback)	void 异步加载当前登录的玩家的排行榜数据。
FetchAll(FetchAllCallback callback)	void 异步加载当前登录玩家的所有排行榜数据。
FetchAll(DataSource data_source, FetchAllCallback callback)	void 异步加载当前登录玩家的所有排行榜数据。
FetchAllBlocking()	FetchAllResponse 同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。
FetchAllBlocking(DataSource data_source)	FetchAllResponse 同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。
FetchAllBlocking(Timeout timeout)	FetchAllResponse 同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。
FetchAllBlocking(DataSource data_source, Timeout timeout)	FetchAllResponse 同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。
FetchAllScoreSummaries(const std::string & leaderboard_id, FetchAllScoreSummariesCallback callback)	void 异步提取特定排行榜的所有得分摘要。
FetchAllScoreSummaries(DataSource data_source, const std::string & leaderboard_id, FetchAllScoreSummariesCallback callback)	void 异步提取特定排行榜的所有得分摘要。
FetchAllScoreSummariesBlocking(const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。
FetchBlocking(const std::string & leaderboard_id)	FetchResponse 同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchResponse 同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchResponse 同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchResponse 同步加载当前已登录玩家的排行榜数据。
FetchScorePage(const ScorePage::ScorePageToken & token, FetchScorePageCallback callback)	void 异步返回由得分页面令牌标识的得分页面的数据。
FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken & token, FetchScorePageCallback callback)	void 异步返回由得分页面令牌标识的得分页面的数据。
FetchScorePage(const ScorePage::ScorePageToken & token, uint32_t max_results, FetchScorePageCallback callback)	void 异步返回由得分页面令牌标识的得分页面的数据。
FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results, FetchScorePageCallback callback)	void 异步返回由得分页面令牌标识的得分页面的数据。
FetchScorePageBlocking(const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。
FetchScoreSummary(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback)	void 异步提取特定排行榜得分摘要的所有数据，其中包括给定排行榜的集合和时间范围。
FetchScoreSummary(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback)	void 异步提取特定排行榜得分摘要的所有数据，其中包括给定排行榜的集合和时间范围。
FetchScoreSummaryBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。
ScorePageToken(const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection) const	ScorePage::ScorePageToken 获取特定排行榜的得分页面令牌，按得分或玩家开始，并涵盖特定时间范围和集合。
ShowAllUI(ShowAllUICallback callback)	void 向用户显示显示所有排行榜相关信息的界面。
ShowAllUI()	void <ph type="x-smartling-placeholder"></ph> 已弃用。。 首选 ShowAllUI(ShowAllUICallback callback)。向用户显示显示所有排行榜相关信息的界面。界面在所有平台上异步显示。
ShowAllUIBlocking()	UIStatus 向用户显示显示所有排行榜相关信息的界面。
ShowAllUIBlocking(Timeout timeout)	UIStatus 向用户显示显示所有排行榜相关信息的界面。
ShowUI(const std::string & leaderboard_id, ShowUICallback callback)	void 向用户显示一个界面，显示特定排行榜的相关信息。
ShowUI(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, ShowUICallback callback)	void 向用户显示一个界面，显示特定排行榜的相关信息。
ShowUI(const std::string & leaderboard_id)	void <ph type="x-smartling-placeholder"></ph> 已弃用。。 首选 ShowUI（ShowUICallback 回调）。用于向用户显示显示特定排行榜相关信息的界面。界面在所有平台上异步显示。
ShowUIBlocking(const std::string & leaderboard_id)	UIStatus 向用户显示一个界面，显示特定排行榜的相关信息。
ShowUIBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus 向用户显示一个界面，显示特定排行榜的相关信息。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id)	UIStatus 向用户显示一个界面，显示特定排行榜的相关信息。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus 向用户显示一个界面，显示特定排行榜的相关信息。
SubmitScore(const std::string & leaderboard_id, uint64_t score)	void 将当前已登录玩家的得分提交到排行榜。
SubmitScore(const std::string & leaderboard_id, uint64_t score, const std::string & metadata)	void 向排行榜提交当前登录的玩家的分数，该得分与特定 ID 和元数据（例如，玩家为获得该分数而采取的操作）相关联。

结构体
gpg::LeaderboardManager::FetchAllResponse	包含所有排行榜的数据和响应状态。
gpg::LeaderboardManager::FetchAllScoreSummariesResponse	包含所有排行榜得分摘要的所有数据和响应状态。
gpg::LeaderboardManager::FetchResponse	保存排行榜数据以及响应状态。
gpg::LeaderboardManager::FetchScorePageResponse	从访问的分数页面返回响应状态和数据。
gpg::LeaderboardManager::FetchScoreSummaryResponse	指定排行榜得分摘要的数据和响应状态。

公共类型

FetchAllCallback

std::function< void(const FetchAllResponse &)> FetchAllCallback

定义 FetchAllResponse 类型的回调。

FetchAllScoreSummariesCallback

std::function< void(const FetchAllScoreSummariesResponse &)> FetchAllScoreSummariesCallback

定义 FetchAllScoreSummariesResponse 类型的回调。

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

定义接收 FetchResponse 的回调类型。

此回调类型提供给下面的 Fetch(*) 函数。

FetchScorePageCallback

std::function< void(const FetchScorePageResponse &)> FetchScorePageCallback

定义 ScorePageResponse 类型的回调。

FetchScoreSummaryCallback

std::function< void(const FetchScoreSummaryResponse &)> FetchScoreSummaryCallback

定义 FetchScoreSummaryResponse 类型的回调。

ShowAllUICallback

std::function< void(const UIStatus &)> ShowAllUICallback

定义接收 UIStatus 的回调类型。

此回调函数类型已提供给下面的 ShowAllUI* 函数。

ShowUICallback

std::function< void(const UIStatus &)> ShowUICallback

定义接收 UIStatus 的回调类型。

此回调函数类型已提供给下面的 ShowUI* 函数。

公共函数

提取

void Fetch(
  const std::string & leaderboard_id,
  FetchCallback callback
)

异步加载当前登录的玩家的排行榜数据。

在操作完成时调用提供的 FetchCallback。如果未指定 data_source，此函数调用等同于调用 Fetch(DataSource data_source, const std::string& leaderboard_id, FetchCallback callback)，且 DataSource 指定为 CACHE_OR_NETWORK。

提取

void Fetch(
  DataSource data_source,
  const std::string & leaderboard_id,
  FetchCallback callback
)

异步加载当前登录的玩家的排行榜数据。

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

FetchAll

void FetchAll(
  FetchAllCallback callback
)

异步加载当前登录玩家的所有排行榜数据。

如果未指定 data_source，则此函数调用等同于调用 FetchAll(DataSource data_source, FetchAllCallback callback)，并将 data_source 指定为 CACHE_OR_NETWORK。

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

异步加载当前登录玩家的所有排行榜数据。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。

既不指定 data_source 也不指定超时，使此函数调用等同于调用 FetchAllResponse FetchAllBlocking（DataSource data_source、TimeoutTimeout），将 data_source 指定为 CACHE_OR_NETWORK，并将超时指定为 10 年。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定超时，则系统会使用您指定的 data_source 值并将超时指定为 10 年，调用 FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。

将超时指定为任意毫秒数。如果未指定 data_source，此函数调用等同于调用 FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)，并将 data_source 指定为 CACHE_OR_NETWORK 和超时值，其中包含您指定的值。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

同步加载当前登录玩家的所有排行榜数据，直接返回 FetchAllResponse。

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

FetchAllScoreSummaries

void FetchAllScoreSummaries(
  const std::string & leaderboard_id,
  FetchAllScoreSummariesCallback callback
)

异步提取特定排行榜的所有得分摘要。

如果未指定 data_source，此函数调用等同于 FetchAllScoreSummaries(DataSource data_source, const std::string&leaderboard_id, FetchAllScoreSummariesCallback callback)，并将 data_source 指定为 CACHE_OR_NETWORK。

FetchAllScoreSummaries

void FetchAllScoreSummaries(
  DataSource data_source,
  const std::string & leaderboard_id,
  FetchAllScoreSummariesCallback callback
)

异步提取特定排行榜的所有得分摘要。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  const std::string & leaderboard_id
)

同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。

如果未指定 data_source 和超时，则此函数调用等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBLOCK( DataSource data_source, const std::string&leaderboard_id)，其中 data_source 指定为 CACHE_OR_NETWORK，超时指定为 10 年。

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  DataSource data_source,
  const std::string & leaderboard_id
)

同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定超时，则此函数调用等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBLOCK(DataSource data_source, const std::string&leaderboard_id)（使用您指定的 data_source 值，并将超时指定为 10 年）。

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  Timeout timeout,
  const std::string & leaderboard_id
)

同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。

指定超时（以毫秒为单位）。如果未指定 data_source，此函数调用等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBLOCK(DataSource data_source, std::string const &leaderboard_id)，并将 data_source 指定为 CACHE_OR_NETWORK，超时包含您为其指定的值。

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & leaderboard_id
)

同步获取特定排行榜的所有得分摘要，直接返回 FetchAllScoreSummariesResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定超时（以毫秒为单位）。

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & leaderboard_id
)

同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。

既不指定 data_source 也不指定超时，则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source, TimeoutTimeout)，且 data_source 指定为 CACHE_OR_NETWORK，超时指定为 10 年。

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & leaderboard_id
)

同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。

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

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & leaderboard_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 & leaderboard_id
)

同步加载当前已登录玩家的排行榜数据。

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

FetchScorePage

void FetchScorePage(
  const ScorePage::ScorePageToken & token,
  FetchScorePageCallback callback
)

异步返回由得分页面令牌标识的得分页面的数据。

既不指定 data_source 也不指定 max_results，则此函数调用等同于 FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken&token, uint32_t max_results, FetchScorePageCallback callback)，且 data_source 指定为 CACHE_OR_NETWORK，max_results 指定为 20。

FetchScorePage

void FetchScorePage(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  FetchScorePageCallback callback
)

异步返回由得分页面令牌标识的得分页面的数据。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定 max_results，则此函数调用等同于 FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken&token, uint32_t max_results, FetchScorePageCallback 回调)，并使用您指定的 data_source 值和 max_results 指定为 20。

FetchScorePage

void FetchScorePage(
  const ScorePage::ScorePageToken & token,
  uint32_t max_results,
  FetchScorePageCallback callback
)

异步返回由得分页面令牌标识的得分页面的数据。

max_results 用于指定要在结果得分页上包含的得分数上限，不得超过 25。如果未指定 data_source，此函数调用等同于 FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken&token, uint32_t max_results, FetchScorePageCallback 回调)，其中 data_source 指定为 CACHE_OR_NETWORK，且 max_results 包含您指定的值。

FetchScorePage

void FetchScorePage(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results,
  FetchScorePageCallback callback
)

异步返回由得分页面令牌标识的得分页面的数据。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。max_results 用于指定要在结果得分页上包含的得分数上限，不得超过 25。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  const ScorePage::ScorePageToken & token
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

既未指定 data_source、Timeout 和 max_results，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, TimeoutTimeout, const ScorePage::ScorePageToken&token, uint32_t max_results)，且 data_source 指定为 CACHE_OR_NETWORK，超时指定为 10 年，max_results 指定为 20

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  const ScorePage::ScorePageToken & token
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

既不指定超时，也不指定 max_results，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，并使用指定的 data_source 值、将超时指定为 10 年、将 max_results 指定为 20。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  Timeout timeout,
  const ScorePage::ScorePageToken & token
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

指定超时（以毫秒为单位）。既不指定 data_source 也不指定 max_results，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，且 data_source 指定为 CACHE_OR_NETWORK，超时包含您指定的值，max_results 指定为 20。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

为 max_results 指定一个值（不超过 25）。既不指定 data_source 也不指定超时，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，并将 data_source 指定为 CACHE_OR_NETWORK，将超时指定为 10 年，并将 max_results 指定为包含您指定的值。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  Timeout timeout,
  const ScorePage::ScorePageToken & token
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定超时（以毫秒为单位）。如果未指定 max_value，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，并将 data_source 和 Timeout 设置为包含您指定的值，并将 max_results 指定为 20。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

可将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY，max_results 为不超过 25 的值。如果未指定超时，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，并将 data_source 和 max_results 设置为包含您指定的值，并将超时指定为 10 年。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  Timeout timeout,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

以毫秒为单位指定超时值，并将 max_results 指定为不超过 25 的值。如果未指定 data_source，则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout time, const ScorePage::ScorePageToken&token, uint32_t max_results)，并将超时和 max_results 设置为包含您指定的值，并将 data_source 指定为 CACHE_OR_NETWORK。

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  Timeout timeout,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

同步返回由得分页面令牌标识的得分页面的数据，直接返回 FetchScorePageResponse。

将 DataSource 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将 超时 指定为任意毫秒数。将 max_results 指定为不超过 25 的值。

FetchScoreSummary

void FetchScoreSummary(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection,
  FetchScoreSummaryCallback callback
)

异步提取特定排行榜得分摘要的所有数据，其中包括给定排行榜的集合和时间范围。

将时间范围指定为 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。如果未指定 data_source，则此函数调用等同于 FetchScoreSummary(DataSource data_source, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback) 与将 data_source 指定为 CACHE_OR_NETWORK 且 collection 和 time_span 包含您指定的值的情况。

FetchScoreSummary

void FetchScoreSummary(
  DataSource data_source,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection,
  FetchScoreSummaryCallback callback
)

异步提取特定排行榜得分摘要的所有数据，其中包括给定排行榜的集合和时间范围。

为 data_source 指定 CACHE_OR_NETWORK 或 NETWORK_ONLY。对于 time_span，请指定 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。

将时间范围指定为 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。既不指定 data_source 也不指定超时，使此函数等同于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout time, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)，将 data_source 指定为 CACHE_OR_NETWORK，超时指定为 10 年，并为 time_span 和 collection 指定值。

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  DataSource data_source,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将时间范围指定为 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。如果未指定超时，则此函数等同于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout time, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)，并使用您指定的 data_source 值、将超时指定为 10 年，以及您为 time_span 和 collection 指定的值。

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。

指定超时（以毫秒为单位）。将时间范围指定为 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。如果未指定 data_source，则此函数等同于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout time, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection 将超时指定为 10 年，并为 data_source、time_span 和 collection 指定值。

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

同步获取特定排行榜得分摘要的所有数据，直接返回 FetchScoreSummaryResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定超时（以毫秒为单位）。将时间范围指定为 DAILY、WEEKLY 或 ALL_TIME。将集合指定为 PUBLIC 或 SOCIAL 属性。

ScorePageToken

ScorePage::ScorePageToken ScorePageToken(
  const std::string & leaderboard_id,
  LeaderboardStart start,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
) const 

获取特定排行榜的得分页面令牌，按得分或玩家开始，并涵盖特定时间范围和集合。

ScorePageToken 在各种排行榜函数中使用，这些函数允许对得分页面进行分页。此函数创建的令牌将始终从请求范围的开头处开始。

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

向用户显示显示所有排行榜相关信息的界面。

它会异步调用 ShowAllUICallback。

ShowAllUI

void ShowAllUI()

<ph type="x-smartling-placeholder"></ph> 已弃用。。 首选 ShowAllUI(ShowAllUICallback callback)。向用户显示显示所有排行榜相关信息的界面。界面在所有平台上异步显示。

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

向用户显示显示所有排行榜相关信息的界面。

它会同步返回一个 UIStatus。如果未指定 timeout，则此函数调用等同于调用 ShowAllUIBlocking(Timeout timeout) 并将 timeout 指定为 10 年。

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

向用户显示显示所有排行榜相关信息的界面。

它会同步返回一个 UIStatus。将 timeout 指定为任意毫秒数。

ShowUI

void ShowUI(
  const std::string & leaderboard_id,
  ShowUICallback callback
)

向用户显示一个界面，显示特定排行榜的相关信息。

它会异步调用 ShowUICallback。

ShowUI

void ShowUI(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  ShowUICallback callback
)

向用户显示一个界面，显示特定排行榜的相关信息。

该方法会异步调用 ShowUICallback，并最初选择传入的 LeaderboardTimeSpan。

ShowUI

void ShowUI(
  const std::string & leaderboard_id
)

<ph type="x-smartling-placeholder"></ph> 已弃用。。 首选 ShowUI（ShowUICallback 回调）。用于向用户显示显示特定排行榜相关信息的界面。界面在所有平台上异步显示。

ShowUIBlocking

UIStatus ShowUIBlocking(
  const std::string & leaderboard_id
)

向用户显示一个界面，显示特定排行榜的相关信息。

它会同步返回一个 UIStatus。如果未指定 timeout，则此函数调用等同于调用 ShowUIBlocking(const string& leaderboard_id, Timeout timeout) 并将 timeout 指定为 10 年。

ShowUIBlocking

UIStatus ShowUIBlocking(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span
)

向用户显示一个界面，显示特定排行榜的相关信息。

它会同步返回一个 UIStatus。如果未指定 timeout，则此函数调用等同于调用 ShowUIBlocking(const string& leaderboard_id, Timeout timeout) 并将 timeout 指定为 10 年。界面最初会选择传入的 LeaderboardTimeSpan。

ShowUIBlocking

UIStatus ShowUIBlocking(
  Timeout timeout,
  const std::string & leaderboard_id
)

向用户显示一个界面，显示特定排行榜的相关信息。

它会同步返回一个 UIStatus。将 timeout 指定为任意毫秒数。

ShowUIBlocking

UIStatus ShowUIBlocking(
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span
)

向用户显示一个界面，显示特定排行榜的相关信息。

它会同步返回一个 UIStatus。将 timeout 指定为任意毫秒数。界面最初会选择传入的 LeaderboardTimeSpan。

SubmitScore

void SubmitScore(
  const std::string & leaderboard_id,
  uint64_t score
)

将当前已登录玩家的得分提交到排行榜。

如果得分低于（由排行榜配置定义）针对同一玩家之前提交的得分，则会被忽略。

SubmitScore

void SubmitScore(
  const std::string & leaderboard_id,
  uint64_t score,
  const std::string & metadata
)

向排行榜提交当前登录的玩家的分数，该得分与特定 ID 和元数据（例如，玩家为获得该分数而采取的操作）相关联。

如果分数差于之前为同一玩家提交的分数（如排行榜配置中所定义），则忽略该分数。