> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# player_ranked_on_leaderboard_version

> player_ranked_on_leaderboard_version event.

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

## 属性

| 名称                    | 类型                                                                                                                      | 说明                                   |
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------- | :----------------------------------- |
| LeaderboardSource     | [LeaderboardSource](/services/playfab/api-references/events/data-types/leaderboardsource)                               | 排行榜的值来源。                             |
| Rank                  | uint32                                                                                                                  | 玩家在排行榜上的排名。                          |
| TitleId               | String                                                                                                                  | 此玩家事件所应用于的游戏的 ID。                    |
| Value                 | int32                                                                                                                   | 玩家的排行榜值。                             |
| Version               | uint32                                                                                                                  | 玩家所在排行榜的版本。对于玩家统计信息排行榜，此值与统计信息的版本匹配。 |
| VersionChangeBehavior | [LeaderboardVersionChangeBehavior](/services/playfab/api-references/events/data-types/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](/services/playfab/api-references/events/data-types/sourcetype) | 此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。                                                                                                                                          |
| Timestamp      | DateTime                                                                    | 与此事件关联的时间（UTC）。                                                                                                                                                                     |


## Related topics

- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [leaderboard_version_ended](/zh-CN/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended.md)
- [PFLeaderboardsIncrementLeaderboardVersionRequest](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsincrementleaderboardversionrequest.md)
- [PFLeaderboardsIncrementLeaderboardVersionResponse](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsincrementleaderboardversionresponse.md)
- [PFLeaderboardsLeaderboardVersionEndConfig](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardversionendconfig.md)