Pular para o conteúdo principal
Este tópico descreve os tipos de entidade disponíveis que você pode usar para construir uma EntityKey. As chaves de entidade identificam entidades na maioria dos métodos de API mais recentes. Você usa o valor do campo EntityKey.Type para determinar o tipo de valor a ser definido no campo ID.
As chaves de entidade diferenciam maiúsculas de minúsculas.

namespace

A entidade namespace representa a identidade do jogador entre títulos e o escopo de dados compartilhados. Por padrão, ela abrange todos os títulos de um estúdio. A Publisher ID identifica esse namespace; publisher é o termo de API mais antigo para o mesmo escopo. O namespace é diferente do estúdio, que é um agrupamento administrativo. Para obter mais informações, consulte Conceitos do PlayFab.
As alterações nessa entidade não são refletidas em tempo real.
Defina o campo ID como a Publisher ID do seu jogo. Para obter sua Publisher ID:
  • Entre no Game Manager.
  • No canto superior esquerdo do Game Manager, selecione o ícone de engrenagem.
  • Selecione Title Settings.
  • Selecione API Features.
  • A Publisher ID, que também é a ID do namespace, é exibida na seção API ACCESS.

title

A entidade title representa as informações globais com escopo de um título. Um título é um recurso isolado do PlayFab para um jogo ou ambiente de jogo.
As alterações nessa entidade não são refletidas em tempo real.
Defina o campo ID como a Title ID do seu jogo. Para obter a Title ID:
  • Entre no Game Manager.
  • No canto superior esquerdo do Game Manager, selecione o ícone de engrenagem.
  • Selecione Title Settings.
  • Selecione API Features.
  • A Title ID é exibida na seção API ACCESS.

master_player_account

A master_player_account é uma entidade de jogador compartilhada por todos os títulos associados a um determinado namespace. Defina o campo ID como o LoginResult.PlayFabId da API clássica. Para obter o LoginResult, chame um dos métodos de login em Client Authentication.

title_player_account

Para a maioria dos desenvolvedores, title_player_account representa o jogador da forma mais tradicional. Defina o campo ID como LoginResult.EntityToken.Entity.Id na API de cliente ou GetEntityTokenResponse.Entity.Id na API de autenticação. Para obter o LoginResult, chame um dos métodos de login em Client Authentication. Para obter o GetEntityTokenResponse, chame Get Entity Token.

character

A entidade character é uma subentidade de title_player_account e é um espelho direto de Characters nas APIs clássicas. Defina o campo ID como qualquer characterId de result.Characters[i].CharacterId.

group

A entidade group é um contêiner para outras entidades. No momento, ela está limitada a jogadores e personagens. Defina o campo ID como result.Group.Id se você estiver criando um grupo, ou result.Groups[i].Group.Id ao listar suas associações.

game_server

A entidade game_server é uma entidade exclusiva usada pelos servidores de jogo principalmente nos recursos de Matchmaking e Lobby. Cenários futuros poderão ser adicionados para oferecer suporte a outros recursos do PlayFab. Essa entidade dá aos servidores de jogo sua própria identidade, o que é útil para identificá-los de forma exclusiva ao assinar atualizações em tempo real de Matchmaking e Lobby, além de oferecer suporte a recursos específicos, como a migração de proprietário do lobby. Para se autenticar como uma entidade game_server, chame a API AuthenticateGameServerWithCustomId como uma entidade de título e obtenha o par de chave e token da entidade game_server. Use essa chave de entidade ao usar o PlayFab Multiplayer SDK com PFMultiplayerSetEntityToken.
Última modificação em 8 de outubro de 2026