> ## 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 메서드에서 엔터티를 식별합니다.

`EntityKey.Type` 필드의 값을 사용하여 `ID` 필드에 설정할 값의 유형을 결정합니다.

<Note>
  엔터티 키는 *대소문자를 구분*합니다.
</Note>

## namespace

`namespace` 엔터티는 스튜디오 내 모든 타이틀에 대한 *모든* 전역 정보를 나타냅니다.

<Note>
  이 엔터티의 변경 사항은 실시간으로 반영되지 *않습니다*.
</Note>

`ID` 필드를 게임의 **Publisher ID**로 설정합니다. **Publisher ID**를 가져오려면:

* [게임 관리자](https://developer.playfab.com/)에 로그인합니다.
* **게임 관리자**의 왼쪽 상단 모서리에서 톱니바퀴 아이콘을 선택합니다.
* \*\*타이틀 설정(Title Settings)\*\*을 선택합니다.
* \*\*API 기능(API Features)\*\*을 선택합니다.
* **Publisher ID**가 **API ACCESS** 섹션에 표시됩니다.

## title

`title` 엔터티는 해당 타이틀에 대한 모든 전역 정보를 나타냅니다.

<Note>
  이 엔터티의 변경 사항은 실시간으로 반영되지 *않습니다*.
</Note>

`ID` 필드를 게임의 **Title ID**로 설정합니다. **Title ID**를 가져오려면:

* [게임 관리자](https://developer.playfab.com/)에 로그인합니다.
* **게임 관리자**의 왼쪽 상단 모서리에서 톱니바퀴 아이콘을 선택합니다.
* \*\*타이틀 설정(Title Settings)\*\*을 선택합니다.
* \*\*API 기능(API Features)\*\*을 선택합니다.
* **Title ID**가 **API ACCESS** 섹션에 표시됩니다.

## master\_player\_account

`master_player_account`는 특정 네임스페이스에 연결된 모든 타이틀 간에 공유되는 플레이어 엔터티입니다.

`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의 캐릭터](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` 엔터티는 주로 매치메이킹 및 로비 기능에서 사용하기 위해 게임 서버가 사용하는 고유한 엔터티입니다. 향후에 다른 PlayFab 기능을 지원하기 위한 시나리오가 추가될 수 있습니다.

이 엔터티는 게임 서버에 고유한 신원을 부여하는데, 이는 매치메이킹과 로비의 실시간 업데이트를 구독하기 위해 고유하게 식별하는 데 유용하며, 로비 소유자 마이그레이션과 같은 특정 기능도 지원합니다.

`game_server` 엔터티로 인증하려면 타이틀 엔터티로 [AuthenticateGameServerWithCustomId](xref:titleid.playfabapi.com.authentication.authentication.authenticategameserverwithcustomid) API를 호출하고 `game_server` 엔터티 키와 토큰 쌍을 검색합니다. PlayFab 멀티플레이어 SDK와 함께 [PFMultiplayerSetEntityToken](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken)을 사용할 때 이 엔터티 키를 사용합니다.


## Related topics

- [PFEntityKey.Type](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/Type.md)
- [엔터티 빠른 시작](/ko/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [PFEntityKey class](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
- [기본 통계 만들기](/ko/services/playfab/player-progression/statistics/create-basic-statistics.md)
- [Postman용 PlayFab REST API 컬렉션 빠른 시작](/ko/services/playfab/sdks/postman/postman-quickstart.md)