> ## 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.

# entity_rank_on_leaderboard_version_ended

> entity_rank_on_leaderboard_version_ended event.

当游戏的排行榜版本重置为新版本时触发此事件，包含来自已结束版本的实体排名和分数数据。

## 属性

| 名称       | 类型       | 说明           |
| -------- | -------- | ------------ |
| Name     | String   | 排行榜的名称       |
| Version  | int32    | 排行榜的版本       |
| Metadata | String   | 与实体关联的自定义元数据 |
| Rank     | int32    | 实体在排行榜中的排名   |
| Scores   | int32\[] | 实体在排行榜中的分数   |

## 通用属性

所有 V2 PlayStream 事件都被格式化为 JSON 对象，且大多数共享以下通用属性：

| 名称                 | 类型                                                                            | 说明                                          |
| :----------------- | :---------------------------------------------------------------------------- | :------------------------------------------ |
| SchemaVersion      | String                                                                        | PlayStream 事件格式版本，遵循语义化版本方案。                |
| FullName           | [Object](/services/playfab/api-references/events/data-types/fullnameobject)   | 事件名称和事件命名空间的组合，用于完全指定事件类型。                  |
| Id                 | String                                                                        | 由 PlayFab 分配的此事件的唯一标识符。                     |
| Timestamp          | DateTime                                                                      | 与此事件关联的时间（UTC）。                             |
| Entity             | [Object](/services/playfab/api-references/events/data-types/entityobject)     | 此事件所应用于的实体的详细信息，包括 Entity Id 和 Entity type。 |
| Originator         | [Object](/services/playfab/api-references/events/data-types/originatorobject) | 描述发起此事件的来源和来源类型的对象。                         |
| PayloadContentType | String                                                                        | 指定事件负载的内容。默认为 "JSON"。                       |
| Origin Info        | Object                                                                        | 可选字段，包含来自 PlayFab 外部的事件的相关信息。               |


## Related topics

- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [排行榜与 PlayStream 和遥测](/zh-CN/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [排行榜的限制](/zh-CN/services/playfab/community/leaderboards/limits-leaderboards.md)
- [PFLeaderboardsLeaderboardEntityRankOnVersionEndConfig](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardentityrankonversionendconfig.md)
- [leaderboard_version_ended](/zh-CN/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended.md)