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

# Eventos do PlayStream

> Compare os eventos PlayFabGenerated e UserGenerated do PlayStream e, em seguida, ingira-os com as APIs WriteEvents, WritePlayerEvent, WriteCharacterEvent ou WriteTitleEvent.

Para ingerir dados com o PlayStream, você pode utilizar quatro APIs diferentes: [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) e [WriteTitleEvent](https://learn.microsoft.com/en-us/rest/api/playfab/server/analytics/write-title-event).

## Eventos PlayFabGenerated vs. eventos UserGenerated

Há dois tipos de eventos disponíveis: **PlayFabGenerated** e **UserGenerated**. Ambos os tipos de eventos são ordenados por jogador, o que significa que, se várias APIs forem chamadas em uma ordem específica, todas as ações disparadas pelos eventos serão executadas na mesma ordem das chamadas de API.

Os eventos PlayFabGenerated são criados pelo PlayFab por meio de uma chamada de API normal.

Os eventos UserGenerated, por outro lado, são criados pelos desenvolvedores, que definem sua estrutura e seus dados, e são específicos dos seus jogos. Esses eventos são totalmente refletidos nas ferramentas de análise em tempo real e, ao contrário dos eventos padrão, você precisa de algum código personalizado para publicá-los.

Os eventos UserGenerated podem ser classificados por entidade e podem ser vinculados a um jogador, personagem ou title. Uma referência de entidade de evento é especificada usando estes dois campos:

* EntityType
* EntityID

Veja a seguir uma tabela de comparação entre algumas características dos eventos PlayFabGenerated e UserGenerated.

| Característica | Eventos PlayFabGenerated | Eventos UserGenerated |
| - | - | - |
| Gerado por | Serviços do PlayFab | Os desenvolvedores |
| Esquema | Esquema padrão (definido pelo PlayFab) | Principalmente esquema personalizado (definido pelos desenvolvedores) |
| Relatórios e modelos | Usados em relatórios e modelos comuns | Não usados em relatórios ou modelos |
| Namespace do evento | V1: "com.playfab" <br /> V2: "events" | V1: "title" <br /> V2: "custom" |
| Como emitir? | N/A | V1: WriteTitleEvent, WritePlayerEvent, WriteCharacterEvent <br /> V2: WriteEvents |

## Eventos de esquema padrão vs. eventos de esquema personalizado

No PlayFab, você pode utilizar tanto eventos PlayFabGenerated de esquema padrão quanto eventos UserGenerated de esquema personalizado, embora estes últimos sejam relativamente limitados em número.

Na tabela a seguir, você encontra exemplos desses dois tipos de eventos.

| Tipo de esquema | Eventos PlayFabGenerated | Eventos UserGenerated |
| - | - | - |
| Esquema padrão | [player\_logged\_in](/pt-BR/services/playfab/api-references/events/PlayerIdentity/player-logged-in) <br /> [entity\_created](/pt-BR/services/playfab/api-references/events/PlayerIdentity/entity-created) | [client\_focus\_change](/pt-BR/services/playfab/api-references/events/Session/client-focus-change) <br /> [client\_session\_start](/pt-BR/services/playfab/api-references/events/Session/client-session-start) |
| Esquema personalizado | N/A | Formato livre |


## Related topics

- [Recursos de eventos do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
- [Eventos do PlayStream do Game Saves](/pt-BR/services/playfab/player-progression/game-saves/playstream-events.md)
- [Referência do modelo de eventos do PlayStream para o PlayFab](/pt-BR/services/playfab/api-references/events/index.md)
- [Estatísticas com PlayStream e telemetria](/pt-BR/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [API de eventos do PlayFab](/pt-BR/services/playfab/api-references/rest/events/overview.md)
