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

# 可用的内置实体类型

> PlayFab 内置实体类型参考：namespace、title、master_player_account、title_player_account、character、group 和 game_server EntityKey 值。

本主题介绍你可以用于构造 [EntityKey](/services/playfab/api-references/events/data-types/entitykey) 的可用实体类型。

在大多数较新的 API 方法中，Entity key 用于标识实体。

你使用 `EntityKey.Type` 字段的值来确定要在 `ID` 字段中设置的值类型。

<Note>
  Entity key *区分大小写*。
</Note>

## namespace

`namespace` 实体指的是工作室内所有 title 的*所有*全局信息。

<Note>
  对此实体的更改*不会*实时反映。
</Note>

将 `ID` 字段设置为你游戏的 **Publisher ID**。要检索你的 **Publisher ID**：

* 登录到 [Game Manager](https://developer.playfab.com/)。
* 在 **Game Manager** 的左上角，选择齿轮图标。
* 选择 **Title Settings**。
* 选择 **API Features**。
* **Publisher ID** 显示在 **API ACCESS** 部分。

## title

`title` 实体指的是该 title 的所有全局信息。

<Note>
  对此实体的更改*不会*实时反映。
</Note>

将 `ID` 字段设置为你游戏的 **Title ID**。要检索 **Title ID**：

* 登录到 [Game Manager](https://developer.playfab.com/)。
* 在 **Game Manager** 的左上角，选择齿轮图标。
* 选择 **Title Settings**。
* 选择 **API Features**。
* **Title ID** 显示在 **API ACCESS** 部分。

## master\_player\_account

`master_player_account` 是一个玩家实体，由与给定 namespace 关联的所有 title 共享。

将 `ID` 字段设置为经典 API 中的 `LoginResult.PlayFabId`。要检索 `LoginResult`，请调用 [Client Authentication](xref:titleid.playfabapi.com.client.authentication) 中的登录方法之一。

## title\_player\_account

对于大多数开发者，`title_player_account` 以最传统的方式表示玩家。

将 `ID` 字段设置为客户端 API 中的 `LoginResult.EntityToken.Entity.Id`，或身份验证 API 中的 `GetEntityTokenResponse.Entity.Id`。

要检索 `LoginResult`，请调用 [Client Authentication](xref:titleid.playfabapi.com.client.authentication) 中的登录方法之一。
要检索 `GetEntityTokenResponse`，请调用 [Get Entity Token](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken)。

## character

`character` 实体是 `title_player_account` 的子实体，是[经典 API 中的 Characters](xref:titleid.playfabapi.com.client.characters.getalluserscharacters) 的直接镜像。

将 `ID` 字段设置为 `result.Characters[i].CharacterId` 中的任何 `characterId`。

## group

`group` 实体是其他实体的容器。目前它仅限于玩家和角色。

如果你正在创建一个组，请将 `ID` 字段设置为 `result.Group.Id`，或在[列出你的成员身份](xref:titleid.playfabapi.com.groups.groups.listmembership)时设置为 `result.Groups[i].Group.Id`。

## game\_server

`game_server` 实体是一个独特的实体，主要供游戏服务器在 Matchmaking 和 Lobby 功能中使用。未来可能会添加场景以支持其他 PlayFab 功能。

此实体让游戏服务器拥有自己的身份，这对于唯一标识它们订阅 Matchmaking 和 Lobby 的实时更新以及支持 Lobby owner migration 等特定功能非常有用。

要以 `game_server` 实体身份进行身份验证，请以 title 实体身份调用 API [AuthenticateGameServerWithCustomId](xref:titleid.playfabapi.com.authentication.authentication.authenticategameserverwithcustomid) 并检索 `game_server` 实体键和令牌对。使用 PlayFab Multiplayer SDK 时，将此实体键与 [PFMultiplayerSetEntityToken](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken) 一起使用。


## Related topics

- [PFEntityKey.Type](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/Type.md)
- [EntityObject](/zh-CN/services/playfab/api-references/events/data-types/entityobject.md)
- [EntityKey](/zh-CN/services/playfab/api-references/events/data-types/entitykey.md)
- [PFEntityKey class](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
- [实体快速入门](/zh-CN/services/playfab/live-service-management/game-configuration/entities/quickstart.md)