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

> 比較 PlayFabGenerated 和 UserGenerated PlayStream 事件，然後使用 WriteEvents、WritePlayerEvent、WriteCharacterEvent 或 WriteTitleEvent API 擷取這些事件。

若要使用 PlayStream 擷取資料，您可以使用四種不同的 API：[WriteEvents](https://learn.microsoft.com/en-us/rest/api/playfab/events/play-stream-events/write-events)、[WritePlayerEvent](https://learn.microsoft.com/en-us/rest/api/playfab/server/analytics/write-player-event)、[WriteCharacterEvent](https://learn.microsoft.com/en-us/rest/api/playfab/server/analytics/write-character-event) 和 [WriteTitleEvent](https://learn.microsoft.com/en-us/rest/api/playfab/server/analytics/write-title-event)。

## PlayFabGenerated 事件與 UserGenerated 事件

可用的事件有兩種類型：**PlayFabGenerated** 和 **UserGenerated**。兩種事件類型都依玩家排序，這表示如果以特定順序呼叫多個 API，事件所觸發的任何動作都會依照與 API 呼叫相同的順序執行。

PlayFabGenerated 事件是由 PlayFab 透過一般 API 呼叫所建立。

另一方面，UserGenerated 事件是由開發人員所建立，開發人員會定義其結構和資料，且這些事件專屬於他們的遊戲。這些事件會完整反映在即時分析工具中，而且與標準事件不同，您需要一些自訂程式碼才能張貼這些事件。

UserGenerated 事件可以依實體分類，並可繫結至玩家、角色或遊戲。事件實體參考是使用下列兩個欄位指定：

* EntityType
* EntityID

下表比較了 PlayFabGenerated 和 UserGenerated 事件的一些特性。

| 特性 | PlayFabGenerated 事件 | UserGenerated 事件 |
| - | - | - |
| 產生者 | PlayFab 服務 | 開發人員 |
| 結構描述 | 標準結構描述 (由 PlayFab 定義) | 大多為自訂結構描述 (由開發人員定義) |
| 報告和範本 | 用於常見報告和範本 | 不用於報告或範本 |
| 事件命名空間 | V1："com.playfab" <br /> V2："events" | V1："title" <br /> V2："custom" |
| 如何發出？ | 不適用 | V1：WriteTitleEvent、WritePlayerEvent、WriteCharacterEvent <br /> V2：WriteEvents |

## 標準結構描述事件與自訂結構描述事件

在 PlayFab 中，您可以同時使用 PlayFabGenerated 標準結構描述事件和 UserGenerated 自訂結構描述事件，不過後者的數量相對有限。

在下表中，您可以找到這兩種事件類型的範例。

| 結構描述類型 | PlayFabGenerated 事件 | UserGenerated 事件 |
| - | - | - |
| 標準結構描述 | [player\_logged\_in](/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-logged-in) <br /> [entity\_created](/zh-TW/services/playfab/api-references/events/PlayerIdentity/entity-created) | [client\_focus\_change](/zh-TW/services/playfab/api-references/events/Session/client-focus-change) <br /> [client\_session\_start](/zh-TW/services/playfab/api-references/events/Session/client-session-start) |
| 自訂結構描述 | 不適用 | 自由格式 |


## Related topics

- [事件](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [PlayStream 事件功能](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
- [PlayStream](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-overview.md)
- [Game Saves PlayStream 事件](/zh-TW/services/playfab/player-progression/game-saves/playstream-events.md)
- [PlayFab 的 PlayStream 事件模型參考](/zh-TW/services/playfab/api-references/events/index.md)