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

# Tipos de entidade internos disponíveis

> Referência dos tipos de entidade internos do PlayFab: valores de EntityKey para namespace, title, master_player_account, title_player_account, character, group e game_server.

Este tópico descreve os tipos de entidade disponíveis que você pode usar para construir uma [EntityKey](/pt-BR/services/playfab/api-references/events/data-types/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`.

<Note>
  As chaves de entidade *diferenciam maiúsculas de minúsculas*.
</Note>

## 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](/pt-BR/services/playfab/get-started/concepts#studios-namespaces-and-titles).

<Note>
  As alterações nessa entidade *não* são refletidas em tempo real.
</Note>

Defina o campo `ID` como a **Publisher ID** do seu jogo. Para obter sua **Publisher ID**:

* Entre no [Game Manager](https://developer.playfab.com/).
* 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.

<Note>
  As alterações nessa entidade *não* são refletidas em tempo real.
</Note>

Defina o campo `ID` como a **Title ID** do seu jogo. Para obter a **Title ID**:

* Entre no [Game Manager](https://developer.playfab.com/).
* 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](xref:titleid.playfabapi.com.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](xref:titleid.playfabapi.com.client.authentication).
Para obter o `GetEntityTokenResponse`, chame [Get Entity Token](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken).

## character

A entidade `character` é uma subentidade de `title_player_account` e é um espelho direto de [Characters nas APIs clássicas](xref:titleid.playfabapi.com.client.characters.getalluserscharacters).

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](xref:titleid.playfabapi.com.groups.groups.listmembership).

## 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](xref:titleid.playfabapi.com.authentication.authentication.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](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken).


## Related topics

- [Início rápido de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [PFEntityKey.Type](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/Type.md)
- [EntityObject](/pt-BR/services/playfab/api-references/events/data-types/entityobject.md)
- [EntityKey](/pt-BR/services/playfab/api-references/events/data-types/entitykey.md)
- [Classe PFEntityKey](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)