> ## 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 は、**エンティティ プログラミング モデル** に対応する新しいイベント モデルである **エンティティ イベント モデル** を導入しました。[エンティティ](/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

- [Azure Functions コンテキスト モデルを使用した PlayFab CloudScript](/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/CloudScript-af-context.md)
- [Game Saves の PlayStream イベント](/ja-jp/services/playfab/player-progression/game-saves/playstream-events.md)
- [PlayStream および Telemetry を使用したリーダーボード](/ja-jp/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [PlayFab Services SDK - イベントパイプライン](/ja-jp/services/playfab/sdks/c/event-pipeline/eventpipeline.md)
- [エンティティハンドル](/ja-jp/services/playfab/sdks/c/entity-handles.md)