Pular para o conteúdo principal
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.

Opções de armazenamento

O PlayFab oferece duas maneiras de armazenar dados de jogadores:
  • Entidades: permitem armazenar dados em objetos e arquivos de jogadores, personagens e grupos.
  • Dados do jogador/UserData: 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. 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 para criar, atualizar ou excluir e 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 para criar, atualizar ou excluir e a API de cliente 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 para criar, atualizar ou excluir e 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 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.
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.
Não confunda os dados de publicador do jogador com os dados de publicador, que são dados de pares de chave/valor compartilhados por todos os títulos (eles não são por jogador).
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.
Última modificação em 8 de outubro de 2026