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 回呼)。為使用者提供顯示所有排行榜資訊的 UI。所有平台上的使用者介面會以非同步方式顯示。
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
已淘汰,,瞭解如何調查及移除這項存取權。 優先使用 ShowUI(ShowUICallback 回呼)。向使用者顯示 UI,顯示特定排行榜的資訊。所有平台上的使用者介面會以非同步方式顯示。
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::LeaderboardManager::FetchAllResponse

包含所有排行榜的資料和回應狀態。

gpg::LeaderboardManager::FetchAllScoreSummariesResponse

包含所有排行榜分數摘要的所有資料和回應狀態。

gpg::LeaderboardManager::FetchResponse

保留排行榜的資料以及回應狀態。

gpg::LeaderboardManager::FetchScorePageResponse

從存取的分數頁面傳回回應狀態和資料。

gpg::LeaderboardManager::FetchScoreSummaryResponse

指定排行榜分數摘要的資料與回應狀態。

公開類型

FetchAllCallback

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

定義 FetchAllResponse 類型回呼。

FetchAllScoreSummariesCallback

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

定義 FetchAllScoreSummariesResponse 類型回呼。

FetchCallback

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

定義接收 FetchResponse 的回呼類型。

這個回呼類型提供給下方的 Fetch(*) 函式。

FetchScorePageCallback

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

定義 ScorePageResponse 類型回呼。

FetchScoreSummaryCallback

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

定義 FetchScoreSummaryResponse 類型回呼。

ShowAllUICallback

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

定義接收 UIStatus 的回呼類型。

這個回呼類型提供給下方的 ShowAllUI* 函式。

ShowUICallback

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

定義接收 UIStatus 的回呼類型。

這個回呼類型提供給下方的 ShowUI* 函式。

公開函式

擷取

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

以非同步方式載入目前登入玩家的排行榜資料。

在作業完成時呼叫提供的 FetchCallback。如未指定 data_source,這個函式呼叫會等同於呼叫 Fetch(DataSource data_source, const std::string& leaderboard_id, FetchCallback callback),且 DataSource 指定為 CACHE_OR_NETWORK。

擷取

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

以非同步方式載入目前登入玩家的排行榜資料。

在作業完成時呼叫提供的 FetchCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。

FetchAll

void FetchAll(
  FetchAllCallback callback
)

以非同步方式載入目前登入玩家的所有排行榜資料。

如未指定 data_source,這個函式呼叫將等同於呼叫 FetchAll(DataSource data_source, FetchAllCallback 回呼) (將 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 和中繼資料 (例如玩家贏得分數) 相關聯的排行榜。

如果分數低於 (定義於排行榜設定中定義) 的相同玩家分數,系統就會予以忽略。