gpg:: LeaderboardManager
#include <leaderboard_manager.h>
获取和设置各种排行榜相关数据。
总结
公共类型 |
|
---|---|
FetchAllCallback
|
typedefstd::function< void(const FetchAllResponse &)>
定义 FetchAllResponse 类型的回调。 |
FetchAllScoreSummariesCallback
|
typedefstd::function< void(const FetchAllScoreSummariesResponse &)>
定义 FetchAllScoreSummariesResponse 类型的回调。 |
FetchCallback
|
typedefstd::function< void(const FetchResponse &)>
定义接收 FetchResponse 的回调类型。 |
FetchScorePageCallback
|
typedefstd::function< void(const FetchScorePageResponse &)>
定义 ScorePageResponse 类型的回调。 |
FetchScoreSummaryCallback
|
typedefstd::function< void(const FetchScoreSummaryResponse &)>
定义 FetchScoreSummaryResponse 类型的回调。 |
ShowAllUICallback
|
typedefstd::function< void(const UIStatus &)>
定义接收 UIStatus 的回调类型。 |
ShowUICallback
|
typedefstd::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
向用户显示一个显示所有排行榜相关信息的界面。
|
ShowAllUI()
|
void
|
ShowAllUIBlocking()
|
向用户显示一个显示所有排行榜相关信息的界面。
|
ShowAllUIBlocking(Timeout timeout)
|
向用户显示一个显示所有排行榜相关信息的界面。
|
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
|
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:: |
包含所有排行榜的数据和响应状态。 |
gpg:: |
包含所有排行榜得分摘要的所有数据和响应状态。 |
gpg:: |
用于保存排行榜的数据和响应状态。 |
gpg:: |
从访问的得分页面返回响应状态和数据。 |
gpg:: |
指定排行榜得分摘要的数据和响应状态。 |
公共类型
FetchAllScoreSummariesCallback
std::function< void(const FetchAllScoreSummariesResponse &)> FetchAllScoreSummariesCallback
定义 FetchAllScoreSummariesResponse
类型的回调。
获取回调
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*
函数。
显示界面回调
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。
提取全部
void FetchAll( FetchAllCallback callback )
异步加载当前已登录玩家的所有排行榜的数据。
如果未指定 data_source,则此函数的调用等同于调用 FetchAll(DataSource data_source, FetchAllCallback callback),并将 data_source 指定为 CACHE_OR_NETWORK。
提取全部
void FetchAll( DataSource data_source, FetchAllCallback callback )
异步加载当前已登录玩家的所有排行榜的数据。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。
提取全部屏蔽
FetchAllResponse FetchAllBlocking()
同步加载当前已登录玩家的所有排行榜的数据,直接返回 FetchAllResponse。
如果既不指定 data_source 也不指定超时,则此函数调用将等同于调用 FetchAllResponse FetchAllBlocked(DataSource data_source、超时超时),data_source 被指定为 CACHE_OR_NETWORK,超时被指定为 10 年。
提取全部屏蔽
FetchAllResponse FetchAllBlocking( DataSource data_source )
同步加载当前已登录玩家的所有排行榜的数据,直接返回 FetchAllResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果不指定超时,则该函数调用将等同于调用 FetchAllResponseFetchAllBlocked(DataSource data_source, Timeout timeout),并以您指定的 data_source 值和超时指定为 10 年。
提取全部屏蔽
FetchAllResponse FetchAllBlocking( Timeout timeout )
同步加载当前已登录玩家的所有排行榜的数据,直接返回 FetchAllResponse。
将超时指定为任意毫秒数。如果未指定 data_source,则此函数调用将等同于调用 FetchAllResponseFetchAllBlocked(DataSource data_source, Timeout timeout),data_source 指定为 CACHE_OR_NETWORK,超时包含您指定的值。
提取全部屏蔽
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& amp; leaderboard_id, FetchAllScoreSummariesCallback 回调) 等效,并且 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。
FetchAllScoreSummaries 阻塞
FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( const std::string & leaderboard_id )
同步获取特定排行榜的所有得分摘要,直接返回 FetchAllScoreSummariesResponse。
如果未指定 data_source 和超时,则此函数调用将等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocked( DataSource data_source, const std::string& amp; leaderboard_id)、data_source 被指定为 CACHE_OR_NETWORK 以及超时被指定为 10 年。
FetchAllScoreSummaries 阻塞
FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( DataSource data_source, const std::string & leaderboard_id )
同步获取特定排行榜的所有得分摘要,直接返回 FetchAllScoreSummariesResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定超时,则此函数调用将等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocked(DataSource data_source, const std::string& amp; leaderboard_id),且您指定的 data_source 值和超时值均为 10 年。
FetchAllScoreSummaries 阻塞
FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( Timeout timeout, const std::string & leaderboard_id )
同步获取特定排行榜的所有得分摘要,直接返回 FetchAllScoreSummariesResponse。
指定超时(以毫秒为单位)。如果未指定 data_source,则此函数调用将等同于 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocked(DataSource data_source, std::string const &leaderboard_id),且 data_source 被指定为 CACHE_OR_NETWORK,且超时包含您为其指定的值。
FetchAllScoreSummaries 阻塞
FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( DataSource data_source, Timeout timeout, const std::string & leaderboard_id )
同步获取特定排行榜的所有得分摘要,直接返回 FetchAllScoreSummariesResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定超时(以毫秒为单位)。
提取阻塞
FetchResponse FetchBlocking( const std::string & leaderboard_id )
同步加载当前已登录玩家的排行榜数据,直接返回 FetchResponse。
如果既不指定 data_source 也不指定超时,则此函数调用将等同于调用 FetchResponse FetchBlocked(DataSource data_source, Timeout timeout)(将 data_source 指定为 CACHE_OR_NETWORK,并将超时指定为 10 年)。
提取阻塞
FetchResponse FetchBlocking( DataSource data_source, const std::string & leaderboard_id )
同步加载当前已登录玩家的排行榜数据,直接返回 FetchResponse。
将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定超时,则此函数调用将等同于调用 FetchResponse FetchBlocked(DataSource data_source, Timeout timeout),并将 data_source 的指定值设为 10 年。
提取阻塞
FetchResponse FetchBlocking( Timeout timeout, const std::string & leaderboard_id )
同步加载当前已登录玩家的排行榜数据,直接返回 FetchResponse。
将超时指定为任意毫秒数。如果未指定 data_source,则此函数调用将等同于调用 FetchResponse FetchBlocked(DataSource data_source, Timeout timeout)(将 data_source 指定为 CACHE_OR_NETWORK,超时则包含您指定的值)。
提取阻塞
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 回调),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 回调,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。
FetchScorePageBinding
FetchScorePageResponse FetchScorePageBlocking( const ScorePage::ScorePageToken & token )
同步返回由得分页面令牌标识的得分页面的数据,直接返回 FetchScorePageResponse。
如果不指定 data_source、 timeout 和 max_results,则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& amp; token, uint32_t max_results),data_source 指定为 CACHE_OR_NETWORK,超时指定为 10 年,max_results 指定为 20。
FetchScorePageBinding
FetchScorePageResponse FetchScorePageBlocking( DataSource data_source, const ScorePage::ScorePageToken & token )
同步返回由得分页面令牌标识的得分页面的数据,直接返回 FetchScorePageResponse。
如果既不指定 timeout,也不指定 max_results,则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& amp; token, uint32_t max_results),将指定的 data_source 值、超时指定为 10 年,max_results 指定为 20。
FetchScorePageBinding
FetchScorePageResponse FetchScorePageBlocking( Timeout timeout, const ScorePage::ScorePageToken & token )
同步返回由得分页面令牌标识的得分页面的数据,直接返回 FetchScorePageResponse。
指定超时(以毫秒为单位)。如果既不指定 data_source 也不指定 max_results,则此函数调用等同于调用 FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& token, uint32_t max_results),其中 data_source 指定为 CACHE_OR_NETWORK,超时包含您指定的值,max_results 指定为 20。
FetchScorePageBinding
FetchScorePageResponse FetchScorePageBlocking( const ScorePage::ScorePageToken & token, uint32_t max_results )
同步返回由得分页面令牌标识的得分页面的数据,直接返回 FetchScorePageResponse。
为 max_results 指定不超过 25 的值。如果既不指定 data_source 也不指定超时,则此函数调用将等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& amp; token, uint32_t max_results),其中 data_source 指定为 CACHE_OR_NETWORK,超时指定为 10 年,max_results 包含指定的值。
FetchScorePageBinding
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 timeout, const ScorePage::ScorePageToken& token, uint32_t max_results),其中 data_source 和 timeout 包含您指定的值,max_results 指定为 20。
FetchScorePageBinding
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 timeout, const ScorePage::ScorePageToken& amp; token, uint32_t max_results),其中 data_source 和 max_results 包含您指定的值,超时指定为 10 年。
FetchScorePageBinding
FetchScorePageResponse FetchScorePageBlocking( Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results )
同步返回由得分页面令牌标识的得分页面的数据,直接返回 FetchScorePageResponse。
以毫秒为单位指定超时,max_results 可采用不超过 25 的值。如果未指定 data_source,则此函数调用将等同于调用 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken& amp; token, uint32_t max_results),超时和 max_results 包含您指定的值,data_source 指定为 CACHE_OR_NETWORK。
FetchScorePageBinding
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 的值。
FetchScore 摘要
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& amp; leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback),并且 data_source 被指定为 CACHE_OR_NETWORK,而 collection 和 time_span 则包含您指定的值。
FetchScore 摘要
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 进行收集。
FetchScoreSummary 阻塞
FetchScoreSummaryResponse FetchScoreSummaryBlocking( const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection )
同步获取特定排行榜得分摘要的所有数据,直接返回 FetchScoreSummaryResponse。
指定时间范围为 DAILY、WEEKLY 或 ALL_TIME。指定 PUBLIC 或 SOCIAL 进行收集。如果既不指定 data_source 也不指定超时,则此函数将等同于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocked(DataSource data_source, Timeout timeout, const std::string& amp; leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection),将 data_source 指定为 CACHE_OR_NETWORK,将超时指定为 10 年,以及您指定的 time_span 和集合值。
FetchScoreSummary 阻塞
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 FetchScoreSummaryBlocked(DataSource data_source, Timeout timeout, const std::string& amp; leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection),同时您指定的 data_source 值、超时值指定为 10 年,以及您指定的 time_span 和 collection 值。
FetchScoreSummary 阻塞
FetchScoreSummaryResponse FetchScoreSummaryBlocking( Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection )
同步获取特定排行榜得分摘要的所有数据,直接返回 FetchScoreSummaryResponse。
指定超时(以毫秒为单位)。指定时间范围为 DAILY、WEEKLY 或 ALL_TIME。指定 PUBLIC 或 SOCIAL 进行收集。如果未指定 data_source,则此函数会等同于调用 FetchScoreSummaryResponse FetchScoreSummaryBlocked(DataSource data_source, Timeout timeout, const std::string& amp; leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection),将超时指定为 10 年,并指定您为 data_source、time_span 和集合指定的值。
FetchScoreSummary 阻塞
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 进行收集。
得分页面令牌
ScorePage::ScorePageToken ScorePageToken( const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection ) const
获取特定排行榜的得分页面令牌,从得分或玩家开始,并涵盖特定时间范围和集合。
ScorePageToken 在各种排行榜函数中使用,这些函数允许对得分页面进行分页。此函数创建的令牌将始终从请求的范围的开头开始。
显示全部界面
void ShowAllUI( ShowAllUICallback callback )
向用户显示一个显示所有排行榜相关信息的界面。
它会异步调用 ShowAllUICallback
。
显示全部界面
void ShowAllUI()
已弃用。 首选 ShowAllUI(ShowAllUICallback callback)。向用户显示一个显示所有排行榜相关信息的界面。界面在所有平台上异步显示。
显示全部界面屏蔽
UIStatus ShowAllUIBlocking()
向用户显示一个显示所有排行榜相关信息的界面。
它会同步返回 UIStatus
。如果未指定 timeout
,则使此函数调用等同于使用指定为 10 年的 timeout
来调用 ShowAllUIBlocking(Timeout timeout)
。
显示全部界面屏蔽
UIStatus ShowAllUIBlocking( Timeout timeout )
向用户显示一个显示所有排行榜相关信息的界面。
它会同步返回 UIStatus
。将 timeout
指定为任意毫秒数。
显示界面
void ShowUI( const std::string & leaderboard_id, ShowUICallback callback )
向用户显示一个显示特定排行榜相关信息的界面。
它会异步调用 ShowUICallback
。
显示界面
void ShowUI( const std::string & leaderboard_id, LeaderboardTimeSpan time_span, ShowUICallback callback )
向用户显示一个显示特定排行榜相关信息的界面。
它会异步调用 ShowUICallback
,并且最初会选择传入的 LeaderboardTimeSpan
。
显示界面
void ShowUI( const std::string & leaderboard_id )
已弃用。 首选 ShowUI(ShowUICallback callback)。向用户显示一个界面,其中显示特定排行榜的相关信息。界面在所有平台上异步显示。
显示界面屏蔽
UIStatus ShowUIBlocking( const std::string & leaderboard_id )
向用户显示一个显示特定排行榜相关信息的界面。
它会同步返回 UIStatus
。如果未指定 timeout
,则使此函数调用等同于使用指定为 10 年的 timeout
来调用 ShowUIBlocking(const string& leaderboard_id, Timeout timeout)
。
显示界面屏蔽
UIStatus ShowUIBlocking( const std::string & leaderboard_id, LeaderboardTimeSpan time_span )
向用户显示一个显示特定排行榜相关信息的界面。
它会同步返回 UIStatus
。如果未指定 timeout
,则使此函数调用等同于使用指定为 10 年的 timeout
来调用 ShowUIBlocking(const string& leaderboard_id, Timeout timeout)
。界面最初会选择传入的 LeaderboardTimeSpan
。
显示界面屏蔽
UIStatus ShowUIBlocking( Timeout timeout, const std::string & leaderboard_id )
向用户显示一个显示特定排行榜相关信息的界面。
它会同步返回 UIStatus
。将 timeout
指定为任意毫秒数。
显示界面屏蔽
UIStatus ShowUIBlocking( Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span )
向用户显示一个显示特定排行榜相关信息的界面。
它会同步返回 UIStatus
。将 timeout
指定为任意毫秒数。界面最初会选择传入的 LeaderboardTimeSpan
。
提交分数
void SubmitScore( const std::string & leaderboard_id, uint64_t score )
向当前玩家提交排行榜得分。
如果得分低于(针对排行榜配置所定义的)同一玩家之前提交的得分,则该得分将被忽略。
提交分数
void SubmitScore( const std::string & leaderboard_id, uint64_t score, const std::string & metadata )
针对当前已登录的玩家,向排行榜提交与特定 ID 和元数据(例如,玩家为获得该得分而执行的操作)相关联的得分。
如果得分低于(针对排行榜配置中所定义的)同一玩家之前提交的得分,则该得分会被忽略。