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 和中繼資料 (例如玩家為了贏得分數) 相關的分數。
|
結構 |
|
---|---|
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),並指定 data_source 值,並將逾時指定為 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 指定為 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, Timeout timeout, const ScorePage::ScorePageToken& Token、uint32_t max_results)、data_source 指定為 CACHE_OR_NETWORK、指定為 CACHE_OR_NETWORK、逾時指定為 10 年。
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 FetchScorePageBlocking(DataSource data_source, Timeout timeout, 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 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)、包含指定值的逾時和 max_results,以及以 CACHE_OR_NETWORK 指定的 data_source。
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 集合, FetchScoreSummaryCallback 回呼),並將 data_source 指定為 CACHE_OR_NETWORK,以及包含指定值的集合和 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 FetchScoreSummary 封鎖(DataSource data_source, Timeout timeout, const std::string& Leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection 集合),其中 data_source 指定為 CACHE_OR_NETWORK、指定為 10 年的逾時值,以及指定的時間_span 和收集時間值。
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 FetchScoreSummary 封鎖(DataSource data_source, Timeout timeout, const std::string& Leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection_id)、指定的 data_source 值、逾時設定為 10 年,以及指定的時間_span 和集合值。
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 FetchScoreSummary 封鎖(DataSource data_source, Timeout timeout, const std::string& Leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection 集合),並將逾時設為 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 在各種 Leaderboard 函式中使用,用於分頁分數頁面。這個函式建立的權杖一律會從要求範圍的開頭開始。
ShowAllUI
void ShowAllUI( ShowAllUICallback callback )
向使用者顯示一項 UI,可顯示所有排行榜的相關資訊。
會以非同步方式呼叫 ShowAllUICallback
。
ShowAllUI
void ShowAllUI()
已淘汰。 偏好使用 ShowAllUI(ShowAllUICallback 回呼)。向使用者顯示 UI,可顯示所有排行榜的相關資訊。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,可顯示特定排行榜的相關資訊。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 和中繼資料 (例如玩家為了贏得分數) 相關的分數。
如果分數低於 (如排行榜設定中所定義) 和先前為同一玩家提交的分數,系統會忽略該分數。