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 同步載入目前登入玩家的所有排行榜資料，直接傳回 FetchAllResponse。
FetchAllBlocking(DataSource data_source)	FetchAllResponse 同步載入目前登入玩家的所有排行榜資料，直接傳回 FetchAllResponse。
FetchAllBlocking(Timeout timeout)	FetchAllResponse 同步載入目前登入玩家的所有排行榜資料，直接傳回 FetchAllResponse。
FetchAllBlocking(DataSource data_source, Timeout timeout)	FetchAllResponse 同步載入目前登入玩家的所有排行榜資料，直接傳回 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 同步擷取特定排行榜的所有分數摘要，直接傳回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步擷取特定排行榜的所有分數摘要，直接傳回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步擷取特定排行榜的所有分數摘要，直接傳回 FetchAllScoreSummariesResponse。
FetchAllScoreSummariesBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse 同步擷取特定排行榜的所有分數摘要，直接傳回 FetchAllScoreSummariesResponse。
FetchBlocking(const std::string & leaderboard_id)	FetchResponse 同步載入目前登入玩家的排行榜資料，直接傳回 FetchResponse。
FetchBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchResponse 同步載入目前登入玩家的排行榜資料，直接傳回 FetchResponse。
FetchBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchResponse 同步載入目前登入玩家的排行榜資料，直接傳回 FetchResponse。
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchResponse 同步載入目前登入玩家的排行榜資料。
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 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 FetchScorePageResponse。
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse 同步傳回由分數頁面符記識別的分數頁面資料，並直接傳回 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 同步擷取特定排行榜分數摘要的所有資料，直接傳回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步擷取特定排行榜分數摘要的所有資料，直接傳回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步擷取特定排行榜分數摘要的所有資料，直接傳回 FetchScoreSummaryResponse。
FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse 同步擷取特定排行榜分數摘要的所有資料，直接傳回 FetchScoreSummaryResponse。
ScorePageToken(const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection) const	ScorePage::ScorePageToken 取得特定排行榜的分數頁面符記，從得分或玩家開始，包含特定時間範圍和集合。
ShowAllUI(ShowAllUICallback callback)	void 向使用者顯示一項 UI，可顯示所有排行榜的相關資訊。
ShowAllUI()	void 已淘汰。 偏好使用 ShowAllUI(ShowAllUICallback 回呼)。向使用者顯示 UI，可顯示所有排行榜的相關資訊。UI 在所有平台上會以非同步方式顯示。
ShowAllUIBlocking()	UIStatus 向使用者顯示一項 UI，可顯示所有排行榜的相關資訊。
ShowAllUIBlocking(Timeout timeout)	UIStatus 向使用者顯示一項 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，可顯示特定排行榜的相關資訊。UI 在所有平台上會以非同步方式顯示。
ShowUIBlocking(const std::string & leaderboard_id)	UIStatus 向使用者顯示一項 UI，可顯示特定排行榜的相關資訊。
ShowUIBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus 向使用者顯示一項 UI，可顯示特定排行榜的相關資訊。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id)	UIStatus 向使用者顯示一項 UI，可顯示特定排行榜的相關資訊。
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus 向使用者顯示一項 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::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)，並指定 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 和中繼資料 (例如玩家為了贏得分數) 相關的分數。

如果分數低於 (如排行榜設定中所定義) 和先前為同一玩家提交的分數，系統會忽略該分數。