> ## 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에 보내고, 플레이어, 타이틀, 캐릭터, 그룹 등에 대한 통합된 엔터티 이벤트 모델을 사용하세요.

PlayFab은 **entity 프로그래밍 모델**에 해당하는 새로운 이벤트 모델인 **entity 이벤트 모델**을 도입했습니다. [entity](/services/playfab/live-service-management/game-configuration/entities)는 데이터를 포함하는 모든 PlayFab 개념을 의미합니다. 플레이어, 타이틀, 캐릭터, 그룹 등이 될 수 있습니다.

클래식 이벤트 모델에서는 각 유형의 엔터티에 대해 서로 다른 이벤트와 API가 존재했습니다. 예를 들어, 새 엔터티를 만들 때 어떤 유형의 엔터티가 생성되었는지에 따라 `group_created`, `character_created` 또는 `player_created`와 같은 이벤트를 볼 수 있었습니다. 엔터티 이벤트 모델에서는 위의 모든 항목을 포함하는 단일 이벤트 `entity_created`만 있습니다.

새로운 엔터티 형식을 통해 존재하는 다양한 API와 이벤트의 수를 단순화할 수 있었습니다. 새로운 이벤트 모델로의 마이그레이션을 완료하는 동안 기존 타이틀을 지원하기 위해, PlayStream 모니터에서 엔터티 이벤트와 함께 클래식 이벤트를 계속 볼 수 있습니다.

엔터티 이벤트는 다음과 같은 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 Functions 포함 CloudScript 포함)
  * 이메일 전송
* **실시간 디버거** - [PlayStream 모니터](/services/playfab/data-analytics/ingest-data/playstream-overview)에서 클래식 이벤트와 함께 엔터티 이벤트가 표시되는 것을 확인합니다.

<Note>
  현재 PlayStream은 이름이 40자보다 긴 이벤트에 대한 규칙 생성을 지원하지 않습니다.
</Note>

엔터티 이벤트는 게임에 대한 관련 정보를 발견할 수 있게 해주는 데이터 및 분석 기능에서도 지원됩니다.

* **PlayFab Insights** - 클래식과 엔터티 이벤트를 모두 포함한 모든 이벤트 데이터를 함께 검토할 수 있는 도구를 제공합니다.


## Related topics

- [action_executed](/ko/services/playfab/api-references/events/PlayStream/action-executed.md)
- [action_failed](/ko/services/playfab/api-references/events/PlayStream/action-failed.md)
- [player_banned](/ko/services/playfab/api-references/events/PlayerIdentity/player-banned.md)
- [player_created](/ko/services/playfab/api-references/events/PlayerIdentity/player-created.md)
- [player_logged_in](/ko/services/playfab/api-references/events/PlayerIdentity/player-logged-in.md)