排行榜的限制 - XBOX Game Development Documentation

本指南的目的是詳細說明在 Leaderboards 服務上建立、更新及讀取排行榜時所強制執行的限制。

呼叫者：此類型的限制會強制套用於 API 的呼叫者。此限制條件可能是玩家或遊戲。
目標：此類型的限制會強制套用於 API 的目標，在我們的特定案例中是實體。

下表概述 Leaderboards 服務中各種可用 API 的限制。如果此處未明確列出某個 API，則會套用預設行為。

API	限制	呼叫者	目標實體
預設	每 120 秒 50 個要求	玩家	`title_player_account` , `master_player_account`, `group`, `character`
GetLeaderboard	每 120 秒 30 個要求 / 每 120 秒 1,200 個要求	玩家 / 遊戲	不適用
GetLeaderboardAroundEntity	每 120 秒 30 個要求	玩家	`title_player_account`, `master_player_account` , `group`, `character`
GetFriendLeaderboardForEntity	每 120 秒 30 個要求	玩家	`title_player_account`, `master_player_account` , `group`, `character`
GetLeaderboardDefinition	每 120 秒 30 個要求	遊戲	不適用
ListLeaderboardDefinitions	每 120 秒 30 個要求	遊戲	不適用
CreateLeaderboardDefinition	每 120 秒 30 個要求	遊戲	不適用
UnlinkLeaderboardFromStatistic	每 120 秒 30 個要求	遊戲	不適用
IncrementLeaderboardVersion	2 分鐘內 30 個要求	遊戲	不適用

排行榜事件的限制

playfab.leaderboard.entity_rank_on_leaderboard_version_ended
- 最多只會傳回前 1000 名的排名。
- 不適用於實體類型為 master_player_account 或 external 的排行榜。

另請參閱

最後修改於 2026年10月6日

相關主題

排行榜與 PlayStream 和 Telemetry 排行榜配額季節性排行榜事件型排行榜的範例程式碼事件型排行榜的入口網站設定

⌘I