排行榜的限制 - XBOX Game Development Documentation

本指南的目的是详细介绍在排行榜服务上创建、更新和读取排行榜时强制执行的限制。

调用方：这种类型的限制针对 API 的调用方强制执行。此约束可能是玩家或标题。
目标：这种类型的限制针对 API 的目标强制执行，在我们的具体情况下即实体。

下表概述了排行榜服务中提供的各种 API 的限制。如果某个 API 未在此明确列出，则适用默认行为。

API	限制	调用方	目标实体
Default	每 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年8月13日

相关主题

排行榜与 PlayStream 和遥测排行榜的更多用法组排行榜排行榜配额季节性排行榜

⌘I