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
向使用者顯示 UI,顯示所有排行榜的相關資訊。
|
ShowAllUI()
|
void
|
ShowAllUIBlocking()
|
向使用者顯示 UI,顯示所有排行榜的相關資訊。
|
ShowAllUIBlocking(Timeout timeout)
|
向使用者顯示 UI,顯示所有排行榜的相關資訊。
|
ShowUI(const std::string & leaderboard_id, ShowUICallback callback)
|
void
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
ShowUI(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, ShowUICallback callback)
|
void
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
ShowUI(const std::string & leaderboard_id)
|
void
|
ShowUIBlocking(const std::string & leaderboard_id)
|
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
ShowUIBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span)
|
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id)
|
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span)
|
向使用者顯示 UI,顯示特定排行榜的相關資訊。
|
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 和中繼資料 (例如玩家贏得分數) 相關聯的排行榜。
|
Structs |
|
---|---|
gpg:: |
包含所有排行榜的資料和回應狀態。 |
gpg:: |
包含所有排行榜分數摘要的所有資料和回應狀態。 |
gpg:: |
保留排行榜的資料以及回應狀態。 |
gpg:: |
從存取的分數頁面傳回回應狀態和資料。 |
gpg:: |
指定排行榜分數摘要的資料與回應狀態。 |
公開類型
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 回呼) (將 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、Timeout timeout)(將 data_source 指定為 CACHE_OR_NETWORK,逾時期限指定為 10 年)。
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source )
系統會同步載入目前登入玩家的所有排行榜資料,直接傳回 FetchAllResponse。
將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果不指定逾時,這個函式呼叫將等同於呼叫 FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout) (指定您指定的 data_source 值及逾時為 10 年)。
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 回呼),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 FetchAllScoreSummariesBlocking( 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 FetchAllScoreSummariesBlocking(DataSource data_source, const std::string&leaderboard_id),並指定以 10 年為單位指定逾時時間。
FetchAllScoreSummariesBlocking
FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking( Timeout timeout, const std::string & leaderboard_id )
同步擷取特定排行榜的所有分數摘要,直接傳回 FetchAllScoreSummariesResponse。
指定逾時時間 (以毫秒為單位)。如未指定 data_source,這個函式呼叫會等同於 FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(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, Timeout timeout) 並使用 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 timeout) 並使用您所指定的 data_source 值,逾時 (指定為 10 年)。
FetchBlocking
FetchResponse FetchBlocking( Timeout timeout, const std::string & leaderboard_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 & 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 指定為 CACHE_OR_NETWORK。
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 的值。
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, Timeout timeout, const ScorePage::ScorePageToken&token, uint32_t max_results),且 data_source 指定為 CACHE_OR_NETWORK、指定逾時為 10 年,且 max_results 指定為 20_results
FetchScorePageBlocking
FetchScorePageResponse FetchScorePageBlocking( DataSource data_source, const ScorePage::ScorePageToken & token )
同步傳回以計分頁符記識別的分數網頁資料,直接傳回 FetchScorePageResponse。
不論是指定逾時設定還是 max_results,這個函式呼叫都等同於呼叫 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, 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 FetchScorePageBlock(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken&token, uint32_t max_results),且 data_source 指定為 CACHE_OR_NETWORK、指定值為 20 的逾時值; 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 timeout, 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 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 的值。如果不指定逾時,這個函式呼叫將等同於呼叫 FetchScorePageResponse FetchScorePageBlocking(DataSource data_source, Timeout timeout, 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 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。逾時的時間指定為任意毫秒數。您可以指定 max_results 做為值 (最多 25 個)。
FetchScoreSummary
void FetchScoreSummary( const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback )
以非同步方式擷取特定排行榜分數摘要的所有資料,其中包含特定排行榜的集合和時間範圍。
針對時間範圍指定 DAILY、WEEKLY 或 ALL_TIME。指定集合時,請指定「公開」或「社交」。如未指定 data_source,這個函式呼叫會等同於 FetchScoreSummary(DataSource data_source, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback 回呼),指定含有指定值的 data_source 和 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。指定集合時,請指定「公開」或「社交」。
FetchScoreSummaryBlocking
FetchScoreSummaryResponse FetchScoreSummaryBlocking( const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection )
同步擷取特定排行榜分數摘要的所有資料,直接傳回 FetchScoreSummaryResponse。
針對時間範圍指定 DAILY、WEEKLY 或 ALL_TIME。指定集合時,請指定「公開」或「社交」。如果未指定 data_source 和逾時,這個函式會等同於呼叫 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection),指定 data_source 為 CACHE_OR_NETWORK 指定的逾時時間,以及限期指定期間的值。
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。指定集合時,請指定「公開」或「社交」。如果不指定逾時,這個函式等同於呼叫 FetchScoreSummaryResponse FetchScoreSummaryBlocking(DataSource data_source, TimeoutTimeout, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection 集合)。
FetchScoreSummaryBlocking
FetchScoreSummaryResponse FetchScoreSummaryBlocking( Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection )
同步擷取特定排行榜分數摘要的所有資料,直接傳回 FetchScoreSummaryResponse。
指定逾時時間 (以毫秒為單位)。針對時間範圍指定 DAILY、WEEKLY 或 ALL_TIME。指定集合時,請指定「公開」或「社交」。如果不指定 data_source,這個函式會等同於呼叫 FetchScoreSummaryResponse FetchScoreSummaryBlock(DataSource data_source, Timeout timeout, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardTimeSpan time_span, Leaderboard-Collection),指定逾時期限為 10 年,以及您在資料收集的時限收集的值。
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。指定集合時,請指定「公開」或「社交」。
ScorePageToken
ScorePage::ScorePageToken ScorePageToken( const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection ) const
取得特定排行榜的分數頁面符記,以得分或玩家為開始,範圍涵蓋特定時間範圍和集合。
ScorePageToken 用於各種排行榜函式,能夠允許分頁分數頁面。這個函式建立的權杖一律會從要求的範圍開頭開始。
ShowAllUI
void ShowAllUI( ShowAllUICallback callback )
向使用者顯示 UI,顯示所有排行榜的相關資訊。
非同步呼叫 ShowAllUICallback
。
ShowAllUI
void ShowAllUI()
已淘汰,,瞭解如何調查及移除這項存取權。 優先使用 ShowAllUI(ShowAllUICallback 回呼)。為使用者提供顯示所有排行榜資訊的 UI。所有平台上的使用者介面會以非同步方式顯示。
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 )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
非同步呼叫 ShowUICallback
。
ShowUI
void ShowUI( const std::string & leaderboard_id, LeaderboardTimeSpan time_span, ShowUICallback callback )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
它會以非同步方式呼叫 ShowUICallback
,而且一開始會選取傳入的 LeaderboardTimeSpan
。
ShowUI
void ShowUI( const std::string & leaderboard_id )
已淘汰,,瞭解如何調查及移除這項存取權。 優先使用 ShowUI(ShowUICallback 回呼)。向使用者顯示 UI,顯示特定排行榜的資訊。所有平台上的使用者介面會以非同步方式顯示。
ShowUIBlocking
UIStatus ShowUIBlocking( const std::string & leaderboard_id )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
以同步方式傳回 UIStatus
。如未指定 timeout
,這個函式呼叫會等同於呼叫 ShowUIBlocking(const string& leaderboard_id, Timeout timeout)
,其中 timeout
已指定為 10 年。
ShowUIBlocking
UIStatus ShowUIBlocking( const std::string & leaderboard_id, LeaderboardTimeSpan time_span )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
以同步方式傳回 UIStatus
。如未指定 timeout
,這個函式呼叫會等同於呼叫 ShowUIBlocking(const string& leaderboard_id, Timeout timeout)
,其中 timeout
已指定為 10 年。UI 一開始會選取傳入的 LeaderboardTimeSpan
。
ShowUIBlocking
UIStatus ShowUIBlocking( Timeout timeout, const std::string & leaderboard_id )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
以同步方式傳回 UIStatus
。將 timeout
指定為任意毫秒數。
ShowUIBlocking
UIStatus ShowUIBlocking( Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span )
向使用者顯示 UI,顯示特定排行榜的相關資訊。
以同步方式傳回 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 和中繼資料 (例如玩家贏得分數) 相關聯的排行榜。
如果分數低於 (定義於排行榜設定中定義) 的相同玩家分數,系統就會予以忽略。