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

> 使用 WriteEvents API 向 PlayStream 发送批处理实体事件，并为玩家、title、角色、群组等使用统一的实体事件模型。

PlayFab 已引入**实体事件模型**，这是一种与**实体编程模型**相对应的新事件模型。[实体](/services/playfab/live-service-management/game-configuration/entities) 是指任何包含数据的 PlayFab 概念。这可以是玩家、title、角色、群组等。

在经典事件模型中，每种实体类型都存在不同的事件和 API。例如，创建新实体时，你会看到 `group_created`、`character_created` 或 `player_created` 等事件，具体取决于创建的实体类型。在实体事件模型下，只有一个事件 `entity_created` 涵盖所有上述内容。

使用新的实体格式，我们能够简化存在的不同 API 和事件的数量。你将继续在 PlayStream 监视器中看到经典事件和实体事件同时存在，以便在我们完成迁移到新事件模型时支持现有 title。

实体事件支持以下 PlayFab 功能：

* **事件批处理** - 使用 [WriteEvents](https://learn.microsoft.com/en-us/rest/api/playfab/events/play-stream-events/write-events?view=playfab-rest\&preserve-view=true) API 一次向 PlayStream 写入多个实体事件。
* **实时规则引擎** - 设置对通过 PlayStream 流动的实体事件实时反应的规则，并触发各种 [操作](/services/playfab/data-analytics/acting-data/action-rules-overview)。PlayFab 支持实体事件上的以下操作：
  * 运行自定义 CloudScript（包括带有 Azure 函数的 CloudScript）
  * 发送电子邮件
* **实时调试器** - 在 [PlayStream 监视器](/services/playfab/data-analytics/ingest-data/playstream-overview) 中看到实体事件与经典事件一起出现。

<Note>
  当前 PlayStream 不支持为名称长度超过 40 个字符的事件创建规则。
</Note>

实体事件还支持数据和分析功能，这些功能允许你发现有关游戏的相关信息：

* **PlayFab Insights** - 拥有工具可以一起检查你所有的事件数据，包括经典事件和实体事件。


## Related topics

- [PlayFab 2020 版本发布说明](/zh-CN/services/playfab/release-notes/2020.md)
- [启用或禁用服务生成的事件](/zh-CN/services/playfab/data-analytics/ingest-data/opt-in-events.md)
- [操作和规则快速入门](/zh-CN/services/playfab/data-analytics/acting-data/action-rules-quickstart.md)
- [player_statistic_deleted](/zh-CN/services/playfab/api-references/events/Leaderboards/player-statistic-deleted.md)
- [player_statistic_changed](/zh-CN/services/playfab/api-references/events/Leaderboards/player-statistic-changed.md)