player_ranked_on_leaderboard_version - XBOX Game Development Documentation

当排行榜版本更改时触发此事件，为排名靠前的玩家生成事件，直至达到”Leaderboard version change top rank events sent”设置定义的限制。

属性

名称	类型	说明
LeaderboardSource	LeaderboardSource	排行榜的值来源。
Rank	uint32	玩家在排行榜上的排名。
TitleId	String	此玩家事件所应用于的游戏的 ID。
Value	int32	玩家的排行榜值。
Version	uint32	玩家所在排行榜的版本。对于玩家统计信息排行榜，此值与统计信息的版本匹配。
VersionChangeBehavior	LeaderboardVersionChangeBehavior	版本更改时对排行榜值的处理行为。

通用属性

所有 V1 PlayStream 事件都被格式化为 JSON 对象，并共享以下通用属性：

名称	类型	说明
EntityId	String	此事件所应用于的实体（游戏、玩家等）的标识符。
EntityType	String	此事件所应用于的实体类型（player、title 等）。如果希望 PlayFab 对此实体执行操作，则 EntityType 必须为 ‘player’、‘character’ 或 ‘title’。任何 PlayFab 目前不解析的实体类型都需要以命名空间为前缀（例如 ‘com.mygame.guild’），因为 PlayFab 可能会随时开始解析根实体。
EventId	String	由 PlayFab 分配的此事件的唯一标识符。
EventName	String	此事件的名称。
EventNamespace	String	分配给此事件的命名空间。例如：‘com.myprogram.ads’
Source	String	此 PlayStream 事件的源名称；如果事件源自我们，则为 PlayFab。
SourceType	SourceType	此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。
Timestamp	DateTime	与此事件关联的时间（UTC）。

最后修改于 2026年8月13日

相关主题

PlayFab 的 PlayStream 事件模型参考 leaderboard_version_ended PFLeaderboardsIncrementLeaderboardVersionRequest PFLeaderboardsIncrementLeaderboardVersionResponse PFLeaderboardsLeaderboardVersionEndConfig

⌘I