엔터티 마이그레이션 정보 - XBOX Game Development Documentation

엔터티 API는 현재 계정 및 데이터 시스템의 문제점을 완화하도록 설계된 새로운 접근 패턴을 도입합니다. 여기 제공된 정보는 이전에 타이틀, 플레이어 또는 캐릭터 정보에 대한 데이터 관리를 구현하기 위해 다음 메서드를 사용해 온 경우 유용합니다. 타이틀 액세스:

client/GetTitleData
admin/GetTitleData
server/GetTitleData

플레이어 액세스:

캐릭터 액세스:

client/GetCharacterData
client/UpdateCharacterData

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

용어

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

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

참고 항목

PlayFab 블로그의 엔터티, 오브젝트, 파일 소개.
엔터티 빠른 시작

마지막 수정일 2026년 8월 13일

관련 항목

엔터티 빠른 시작 PlayFab 독립 실행형 SDK v1에서 Unified SDK v2로 마이그레이션 중재자 마이그레이션 XDK 네트워킹을 XBOX GDK로 마이그레이션 호스트 마이그레이션 처리(순서도)

⌘I