EntityKey.Type 필드의 값을 사용하여 ID 필드에 설정할 값의 유형을 결정합니다.
엔터티 키는 대소문자를 구분합니다.
namespace
namespace 엔터티는 스튜디오 내 모든 타이틀에 대한 모든 전역 정보를 나타냅니다.
이 엔터티의 변경 사항은 실시간으로 반영되지 않습니다.
ID 필드를 게임의 Publisher ID로 설정합니다. Publisher ID를 가져오려면:
- 게임 관리자에 로그인합니다.
- 게임 관리자의 왼쪽 상단 모서리에서 톱니바퀴 아이콘을 선택합니다.
- **타이틀 설정(Title Settings)**을 선택합니다.
- **API 기능(API Features)**을 선택합니다.
- Publisher ID가 API ACCESS 섹션에 표시됩니다.
title
title 엔터티는 해당 타이틀에 대한 모든 전역 정보를 나타냅니다.
이 엔터티의 변경 사항은 실시간으로 반영되지 않습니다.
ID 필드를 게임의 Title ID로 설정합니다. Title ID를 가져오려면:
- 게임 관리자에 로그인합니다.
- 게임 관리자의 왼쪽 상단 모서리에서 톱니바퀴 아이콘을 선택합니다.
- **타이틀 설정(Title Settings)**을 선택합니다.
- **API 기능(API Features)**을 선택합니다.
- Title ID가 API ACCESS 섹션에 표시됩니다.
master_player_account
master_player_account는 특정 네임스페이스에 연결된 모든 타이틀 간에 공유되는 플레이어 엔터티입니다.
ID 필드를 클래식 API의 LoginResult.PlayFabId로 설정합니다. LoginResult를 가져오려면 Client Authentication의 로그인 메서드 중 하나를 호출합니다.
title_player_account
대부분의 개발자에게title_player_account는 가장 전통적인 방식으로 플레이어를 나타냅니다.
ID 필드를 클라이언트 API의 LoginResult.EntityToken.Entity.Id 또는 인증 API의 GetEntityTokenResponse.Entity.Id로 설정합니다.
LoginResult를 가져오려면 Client Authentication의 로그인 메서드 중 하나를 호출합니다.
GetEntityTokenResponse를 가져오려면 Get Entity Token을 호출합니다.
character
character 엔터티는 title_player_account의 하위 엔터티이며, 클래식 API의 캐릭터를 직접 반영합니다.
ID 필드를 result.Characters[i].CharacterId의 임의의 characterId로 설정합니다.
group
group 엔터티는 다른 엔터티를 담는 컨테이너입니다. 현재는 플레이어와 캐릭터로 제한됩니다.
그룹을 만드는 경우 ID 필드를 result.Group.Id로 설정하거나, 멤버십을 나열할 때는 result.Groups[i].Group.Id로 설정합니다.
game_server
game_server 엔터티는 주로 매치메이킹 및 로비 기능에서 사용하기 위해 게임 서버가 사용하는 고유한 엔터티입니다. 향후에 다른 PlayFab 기능을 지원하기 위한 시나리오가 추가될 수 있습니다.
이 엔터티는 게임 서버에 고유한 신원을 부여하는데, 이는 매치메이킹과 로비의 실시간 업데이트를 구독하기 위해 고유하게 식별하는 데 유용하며, 로비 소유자 마이그레이션과 같은 특정 기능도 지원합니다.
game_server 엔터티로 인증하려면 타이틀 엔터티로 AuthenticateGameServerWithCustomId API를 호출하고 game_server 엔터티 키와 토큰 쌍을 검색합니다. PlayFab 멀티플레이어 SDK와 함께 PFMultiplayerSetEntityToken을 사용할 때 이 엔터티 키를 사용합니다.