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。
FetchAllBlocking(DataSource data_source)
同步加载当前登录玩家所有排行榜的数据，直接返回 FetchAllResponse。
FetchAllBlocking(Timeout timeout)
同步加载当前登录玩家所有排行榜的数据，直接返回 FetchAllResponse。
FetchAllBlocking(DataSource data_source, Timeout timeout)
同步加载当前登录玩家所有排行榜的数据，直接返回 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。
FetchAllScoreSummariesBlocking(DataSource data_source, const std::string & leaderboard_id)
同步获取特定排行榜的所有分数摘要，直接返回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(Timeout timeout, const std::string & leaderboard_id)
同步获取特定排行榜的所有分数摘要，直接返回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)
同步获取特定排行榜的所有分数摘要，直接返回 FetchAllScoreSummariesResponse。
FetchBlocking(const std::string & leaderboard_id)
同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, const std::string & leaderboard_id)
同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(Timeout timeout, const std::string & leaderboard_id)
同步加载当前登录玩家的排行榜数据，直接返回 FetchResponse。
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)
同步加载当前登录玩家的排行榜数据。
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。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(const ScorePage::ScorePageToken & token, uint32_t max_results)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)
同步返回由分数页面令牌标识的分数页面的数据，直接返回 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。
FetchScoreSummaryBlocking(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)
同步获取特定排行榜分数摘要的所有数据，直接返回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)
同步获取特定排行榜分数摘要的所有数据，直接返回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)
同步获取特定排行榜分数摘要的所有数据，直接返回 FetchScoreSummaryResponse。
ScorePageToken(const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection) const
获取特定排行榜的分数页面令牌，以分数或玩家开头，并涵盖特定时间跨度和集合。
ShowAllUI(ShowAllUICallback callback)
void
向用户展示一个显示所有排行榜信息的 UI。
ShowAllUI()
void
已弃用。 建议使用 ShowAllUI(ShowAllUICallback callback)。向用户显示一个界面，其中显示所有排行榜的信息。该界面在所有平台上异步显示。
ShowAllUIBlocking()
向用户展示一个显示所有排行榜信息的 UI。
ShowAllUIBlocking(Timeout timeout)
向用户展示一个显示所有排行榜信息的 UI。
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
已弃用。 建议使用 ShowUI(ShowUICallback callback)。向用户显示一个界面，其中显示特定排行榜的信息。该界面在所有平台上异步显示。
ShowUIBlocking(const std::string & leaderboard_id)
向用户显示一个界面，其中显示特定排行榜的信息。
ShowUIBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span)
向用户显示一个界面，其中显示特定排行榜的信息。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id)
向用户显示一个界面，其中显示特定排行榜的信息。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span)
向用户显示一个界面，其中显示特定排行榜的信息。
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* 函数。

公共函数

Fetch

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。

Fetch

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 和 timeout 使此函数调用等效于调用 FetchAllResponse FetchAllBlocking (DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 10 年。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

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

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。不指定 timeout 使此函数调用等效于调用 FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)，其中使用您指定的 data_source 值，timeout 指定为 10 年。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

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

将 timeout 指定为任意毫秒数。不指定 data_source 使此函数调用等效于调用 FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 包含您指定的值。

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

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

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

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 和 timeout 使此函数调用等效于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( DataSource data_source, const std::string& leaderboard_id)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 10 年。

FetchAllScoreSummariesBlocking

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

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

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。不指定 timeout 使此函数调用等效于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(DataSource data_source, const std::string& leaderboard_id)，其中使用您指定的 data_source 值，timeout 指定为 10 年。

FetchAllScoreSummariesBlocking

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

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

以毫秒为单位指定 timeout。不指定 data_source 使此函数调用等效于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(DataSource data_source, std::string const &leaderboard_id)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 包含您为其指定的值。

FetchAllScoreSummariesBlocking

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

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

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。以毫秒为单位指定 timeout。

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & leaderboard_id
)

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

不指定 data_source 和 timeout 使此函数调用等效于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 10 年。

FetchBlocking

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

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

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。不指定 timeout 使此函数调用等效于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout)，其中使用您指定的 data_source 值，timeout 指定为 10 年。

FetchBlocking

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

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

将 timeout 指定为任意毫秒数。不指定 data_source 使此函数调用等效于调用 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 包含您指定的值。

FetchBlocking

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

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

直接返回 FetchResponse。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。将 timeout 指定为任意毫秒数。

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 callback)，其中使用您指定的 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 callback)，其中 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, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 10 年，max_results 指定为 20。

FetchScorePageBlocking

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

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

不指定 timeout 和 max_results 使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中使用您指定的 data_source 值，timeout 指定为 10 年，max_results 指定为 20。

FetchScorePageBlocking

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

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

以毫秒为单位指定 timeout。不指定 data_source 和 max_results 使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 包含您指定的值，max_results 指定为 20。

FetchScorePageBlocking

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

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

为 max_results 指定一个不超过 25 的值。不指定 data_source 和 timeout 使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 10 年，max_results 包含您指定的值。

FetchScorePageBlocking

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

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

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。以毫秒为单位指定 timeout。不指定 max_value 使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, 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 的值。不指定 timeout 会使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中 data_source 和 max_results 包含您指定的值，timeout 指定为 10 年。

FetchScorePageBlocking

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

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

以毫秒为单位指定 timeout，并将 max_results 指定为不超过 25 的值。不指定 data_source 会使此函数调用等效于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results)，其中 timeout 和 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。将 Timeout 指定为任意毫秒数。将 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。为时间跨度指定 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 和 timeout 会使此函数等效于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)，其中 data_source 指定为 CACHE_OR_NETWORK，timeout 指定为 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。不指定 timeout 会使此函数等效于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)，其中使用您指定 data_source 值，timeout 指定为 10 年，time_span 和 collection 使用您指定的值。

FetchScoreSummaryBlocking

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

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

以毫秒为单位指定 timeout。为时间跨度指定 DAILY、WEEKLY 或 ALL_TIME。为集合指定 PUBLIC 或 SOCIAL。不指定 data_source 会使此函数等效于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)，其中 timeout 指定为 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。以毫秒为单位指定 timeout。为时间跨度指定 DAILY、WEEKLY 或 ALL_TIME。为集合指定 PUBLIC 或 SOCIAL。

ScorePageToken

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

获取特定排行榜的分数页面令牌，以分数或玩家开头，并涵盖特定时间跨度和集合。

ScorePageToken 用于各种允许分页浏览分数页面的 Leaderboard 函数。此函数创建的令牌将始终从请求范围的开头开始。

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

向用户展示一个显示所有排行榜信息的 UI。

它异步调用 ShowAllUICallback。

ShowAllUI

void ShowAllUI()

已弃用。 建议使用 ShowAllUI(ShowAllUICallback callback)。向用户显示一个界面，其中显示所有排行榜的信息。该界面在所有平台上异步显示。

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

向用户展示一个显示所有排行榜信息的 UI。

它同步返回 UIStatus。不指定 timeout 会使此函数调用等效于调用 ShowAllUIBlocking(Timeout timeout)，其中 timeout 指定为 10 年。

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

向用户展示一个显示所有排行榜信息的 UI。

它同步返回 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
)

已弃用。 建议使用 ShowUI(ShowUICallback callback)。向用户显示一个界面，其中显示特定排行榜的信息。该界面在所有平台上异步显示。

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 年。UI 将最初选择传入的 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 指定为任意毫秒数。UI 将最初选择传入的 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 和元数据关联的排行榜（例如，玩家获得该分数所做的事情）。

如果分数低于（根据排行榜配置中定义）同一玩家先前提交的分数，则会忽略该分数。