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

# Dados do jogador

> Explore os dados do jogador do PlayFab para armazenar campos personalizados de chave-valor por jogador, incluindo dados internos, somente leitura e de título usados na progressão.

Os dados do jogador são um armazenamento por jogador com escopo para entidades de jogador (`title_player_account`, `master_player_account` e `character`). Use-os para armazenar o progresso do jogo, as preferências e outras informações vinculadas a um jogador individual.

Os dados do jogador são um dos vários recursos de armazenamento do PlayFab, cada um com escopo para um tipo de entidade diferente. Para ver uma comparação, consulte [Objetos de entidade](/pt-BR/services/playfab/live-service-management/game-configuration/entities/entity-objects#related-features).

## Opções de armazenamento

O PlayFab oferece duas maneiras de armazenar dados de jogadores:

* [Entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities): permitem armazenar dados em objetos e arquivos de jogadores, personagens e grupos.
* [Dados do jogador/UserData](/pt-BR/services/playfab/player-progression/player-data/quickstart): permitem armazenar dados de pares de chave/valor para os jogadores.

Para oferecer a maior flexibilidade e o melhor desempenho, recomendamos que *todos* os novos títulos usem [objetos de entidade](/pt-BR/services/playfab/live-service-management/game-configuration/entities/entity-objects).

Nas APIs do PlayFab, os nomes das funções usam o termo **UserData**. No **Game Manager**, esse conceito é descrito como **Player Data**. Eles são idênticos e intercambiáveis.

Há três modos de acesso aos dados do jogador:

* Cliente: são dados do jogador disponíveis para o cliente do seu título ler e atualizar. Você usa as APIs de cliente [UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata) para criar, atualizar ou excluir e [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) para ler os dados do jogador.
* Somente leitura: são dados do jogador criados ou atualizados pelo seu servidor. O cliente do seu título pode ler, mas não atualizar, esses dados. Você usa a API de servidor [UpdateUserReadOnlyData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserreadonlydata) para criar, atualizar ou excluir e a API de cliente [GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata) para ler os dados do jogador específicos do título. Esses dados ficam visíveis para o jogador, mas só podem ser modificados pelo servidor.
* Internos: são dados do jogador disponíveis somente para o seu servidor. Você usa as APIs de servidor [UpdateUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserinternaldata) para criar, atualizar ou excluir e [GetUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.getuserinternaldata) para ler os dados do jogador específicos do título. Esses dados são exclusivos do servidor e não podem ser vistos pelo cliente.

Ao usar os dados do jogador, somente User Data e User Read Only Data ficam disponíveis para a API de cliente. Se você tiver dados do jogador que outro jogador deva conseguir ler, precisará definir o valor de `Permission` como `Public` ao gravar os dados.

## Dados do jogador vs. dados de publicador do jogador

Os [dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart) são informações do jogador específicas de um título de jogo. Eles devem ser usados para informações específicas do título, como salvar a posição do jogador em uma masmorra ou outros dados específicos do jogo.

Os dados de publicador do jogador são associados à `master_player_account` do jogador no namespace, e não a uma `title_player_account`. Use-os para salvar informações do jogador relevantes para todos os títulos do namespace, como recompensas entre títulos.

A Publisher ID identifica o namespace; **publisher** é o termo mais antigo da API para esse escopo. Por padrão, todos os títulos de um estúdio compartilham uma Publisher ID. A conta de jogador mestre do jogador fornece a identidade entre títulos nesse namespace, enquanto o jogador também tem dados distintos em cada conta de jogador do título. Para obter mais informações, consulte [Conceitos do PlayFab](/pt-BR/services/playfab/get-started/concepts#studios-namespaces-and-titles).

<Note>
  Algumas configurações legadas têm várias Publisher IDs em um estúdio ou compartilham uma Publisher ID entre estúdios. Essas configurações são incomuns.
</Note>

<Note>
  Não confunda os dados de publicador *do jogador* com os [dados de publicador](/pt-BR/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data), que são dados de pares de chave/valor compartilhados por todos os títulos (eles *não* são por jogador).
</Note>

O uso dos dados de publicador do jogador é quase idêntico ao uso dos dados do jogador. *Ambos* são dicionários que mapeiam uma cadeia de caracteres para um blob JSON (ou outro valor de cadeia de caracteres arbitrário).

Para obter mais informações, consulte [Como usar os dados de publicador do jogador para conceder uma recompensa por jogar vários títulos](/pt-BR/services/playfab/player-progression/player-data/using-player-publisher-data).


## Related topics

- [Dados do jogador](/pt-BR/services/xbox-services/player-data/index.md)
- [Documentação de progressão do jogador do PlayFab](/pt-BR/services/playfab/player-progression/index.md)
- [Visão geral do jogo de demonstração Winter Starfall do PlayFab](/pt-BR/services/playfab/demo-game/overview.md)
- [Início rápido de dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
- [Exportar dados do jogador mestre](/pt-BR/services/playfab/api-references/rest/admin/account-management/export-master-player-data.md)
