> ## 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 계정 및 데이터 API에서 엔터티 API로 이전합니다.

엔터티 API는 현재 계정 및 데이터 시스템의 문제점을 완화하도록 설계된 새로운 접근 패턴을 도입합니다.

여기 제공된 정보는 이전에 타이틀, 플레이어 또는 캐릭터 정보에 대한 데이터 관리를 구현하기 위해 다음 메서드를 사용해 온 경우 유용합니다.

**타이틀** 액세스:

* client/[GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata)
* admin/[GetTitleData](xref:titleid.playfabapi.com.admin.title-widedatamanagement.gettitledata)
* server/[GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata)

**플레이어** 액세스:

* client/[GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata)
* client/[UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata)
* client/[UpdateUserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserpublisherdata)

**캐릭터** 액세스:

* client/[GetCharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata)
* client/[UpdateCharacterData](xref:titleid.playfabapi.com.client.characterdata.updatecharacterdata)

엔터티 API를 사용하면 단일 메서드를 호출하여 타이틀, 플레이어, 캐릭터 엔터티 유형에 대한 데이터 값을 저장할 수 있습니다. 이 API는 사용자 지정 데이터의 기존 시스템 동작을 더 나은 인터페이스로 복제하고 확장하는 접근 규칙을 제공합니다.

일부 측면에서는 이러한 변경 사항이 하위 호환되지 않습니다. 그러나 기존 API의 동작을 변경하지 않고도 엔터티 API에 대한 호출을 추가할 수 있습니다.

## 용어

다음 표는 엔터티 API와 관련된 용어의 개선 사항을 설명합니다.

| 용어                          | 설명                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **title**                   | 이 개념은 변경되지 않았습니다. 타이틀에는 모든 플레이어가 사용할 수 있는 전역 정보가 포함될 수 있습니다. 이는 [TitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata)와 유사합니다. 게임/애플리케이션의 타이틀 ID(`TitleId`)로 식별됩니다.                                                                                                                                                                          |
| **master\_player\_account** | 이 엔터티 유형을 사용하면 스튜디오 내 여러 게임 간에 플레이어 정보를 공유할 수 있습니다. 이는 [UserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserpublisherdata)와 유사합니다. 플레이어의 플레이어 ID(`PlayFabId`)로 식별되며, 이 값은 어떠한 로그인이나 플레이어 계정 정보를 가져오는 호출(예: PlayFab 클라이언트 API [GetAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo))의 일부로 반환됩니다.               |
| **title\_player\_account**  | 이 개념은 기존 API 메서드의 사용자/플레이어를 기반으로 합니다. 각 플레이어는 현재 타이틀에 대한 일부 정보를 포함할 수 있습니다. 이는 [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) 메서드와 유사합니다. 이는 `LoginTitlePlayerAccountEntity`를 `True`로 지정한 로그인에서 [EntityKey](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken#entitykey) 객체로 반환되는 엔터티 ID(`EntityKey.Id`)로 식별됩니다. |
| **character**               | 이 개념은 변경되지 않았습니다. 플레이어는 각각 일부 정보를 포함할 수 있는 캐릭터를 소유할 수 있습니다. 이는 [CharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata)와 유사합니다. 캐릭터의 캐릭터 ID(`CharacterId`)로 식별됩니다.                                                                                                                                                                                |
| **PlayFabId**               | 이전에는 이 용어가 `master_player_account`와 `title_player_account` 개념을 모두 포함했습니다. 이러한 개념을 분리하면 기능이 단순해지고 명확해집니다. 플레이어는 같은 스튜디오에 속한 여러 타이틀과 상호작용할 수 있으므로 각 타이틀에서 다른 `title_player_account`로 고유한 정보를 가질 수 있는 반면, 스튜디오 소유자는 해당 플레이어를 타이틀 전반에 걸쳐 공유 데이터를 가진 하나의 `master_player_account` 엔터티로 식별할 수도 있어야 합니다. 이를 통해 게임 간 교차 프로모션이나 게임 간 보상 제공과 같은 기능이 가능해집니다.                            |

## 참고 항목

* PlayFab 블로그의 [엔터티, 오브젝트, 파일 소개](https://blog.playfab.com/blog/introducing-entities-objects-and-files).
* [엔터티 빠른 시작](/services/playfab/live-service-management/game-configuration/entities/quickstart)


## Related topics

- [엔터티 빠른 시작](/ko/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [PlayFab 독립 실행형 SDK v1에서 Unified SDK v2로 마이그레이션](/ko/services/playfab/sdks/unified-sdk/migrating-from-v1.md)
- [중재자 마이그레이션](/ko/services/xbox-services/multiplayer/concepts/live-migrating-an-arbiter.md)
- [XDK 네트워킹을 XBOX GDK로 마이그레이션](/ko/build/console-features/networking/xdk-migration/index.md)
- [호스트 마이그레이션 처리(순서도)](/ko/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-host-migration.md)