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

# 排行榜与 PlayStream 和遥测

> 将 PlayFab 排行榜的版本结束事件和实体排名事件发送到 PlayStream 或遥测，以触发 CloudScript、Azure Functions 或奖励顶级玩家。

通过将排行榜与 [PlayStream](/services/playfab/data-analytics/ingest-data/playstream-overview) 集成，你可以轻松利用实时事件摄取和处理管道，构建在排行榜版本变更时触发的自定义玩家体验。借助 [PlayStream 操作和规则](/services/playfab/data-analytics/acting-data/action-rules-quickstart)，你可以触发自定义的 [CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript) 或 [Azure Functions](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)，以驱动参与度和留存功能，例如[向顶级玩家授予奖励](/services/playfab/economy-monetization/economy-v2/inventory)、向玩家发送个性化通知，或执行分数验证以检查作弊者。PlayStream 事件也将存档在数据资源管理器中，用于数据分析和数据仓库。

如果你只需要数据分析和数据仓库功能而不需要实时事件操作，排行榜还与[遥测事件](/services/playfab/data-analytics/ingest-data/telemetry-overview)集成，仅提供分析功能。

排行榜提供两个可选事件：

* [`playfab.leaderboard.leaderboard_version_ended`](/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)

这两个事件允许你快速了解排行榜版本何时结束，并允许你根据需要立即查询以前的数据。借助排行榜版本结束时的实体排名事件，你可以获取该排行榜版本结束时排名最高的实体的排名和分数。

## 启用 PlayStream 或遥测事件

你可以在创建新排行榜或编辑现有排行榜定义时启用事件。找到 PlayStream 和遥测事件配置部分，然后选择 None、PlayStream 或 Telemetry。

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/create-leaderboard-with-events.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=c45d0ef67226e657e6e7c272ea3c0279" alt="该图显示了一个用于设置事件参数的配置屏幕，包括重置频率、排行榜事件和实体排名限制。" width="1157" height="830" data-path="images/playfab/community/leaderboards/create-leaderboard-with-events.png" />

> **注意：** 预先存在的排行榜默认关闭排行榜版本结束事件和排行榜版本结束时的实体排名事件。如果你想启用它们或只启用其中之一，请转到你想要修改的排行榜并启用该设置。

一旦提交，每当排行榜版本变更时就会发出事件。

## 事件用法

若要了解如何利用这些事件执行不同的操作，例如连接到 Azure 函数，请查看以下资源：

* [将 CloudScript 操作与 PlayStream 结合使用](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [快速入门：使用 Azure Functions 编写 PlayFab CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 快速入门](/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)

## 限制和注意事项

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` 事件仅返回排名前 1000 名。

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` 事件将为排行榜内的每一条目发送一个事件。

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` 事件不适用于实体类型为 `master_player_account` 或 `external` 的排行榜。

## 另请参阅

* [`playfab.leaderboard.leaderboard_version_ended`](/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)
* [PlayStream 概述](/services/playfab/data-analytics/ingest-data/playstream-overview)
* [统计信息与 PlayStream 和遥测](/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry)。
* [遥测概述](/services/playfab/data-analytics/ingest-data/telemetry-overview)
* [定价计量表](/services/playfab/pricing/meters/meters)
* [PlayStream 事件功能](/services/playfab/data-analytics/ingest-data/playstream-event-capabilities)
* [将 CloudScript 操作与 PlayStream 结合使用](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [快速入门：使用 Azure Functions 编写 PlayFab CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [CloudScript 快速入门](/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)
* [排行榜的限制](/services/playfab/community/leaderboards/limits-leaderboards)
* [排行榜与 CloudScript](/services/playfab/community/leaderboards/leaderboards-cloudscript)。


## Related topics

- [PlayFab 排行榜概述](/zh-CN/services/playfab/community/leaderboards/index.md)
- [使用 PlayStream 和遥测的统计信息](/zh-CN/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [排行榜配额](/zh-CN/services/playfab/community/leaderboards/quota-leaderboards.md)
- [季节性排行榜](/zh-CN/services/playfab/community/leaderboards/seasonal-leaderboards.md)
- [排行榜的限制](/zh-CN/services/playfab/community/leaderboards/limits-leaderboards.md)
