다음을 통해 공유


사용 가능한 기본 제공 엔터티 유형

이 항목에서는 EntityKey를 구성하는 데 사용 가능한 엔티티 유형을 설명합니다.

엔터티 키는 대다수의 최신 API 메서드에서 엔터티를 식별합니다.

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

참고 항목

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

namespace

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

참고 항목

이 엔터티에 대한 변경 내용은 실시간으로 반영되지 않습니다.

ID 필드를 게임의 게시자 ID로 설정합니다. 게시자 ID를 검색하는 방법:

  • 게임 관리자에 로그인합니다.
  • 게임 관리자의 왼쪽 상단 모서리에서 기어 아이콘을 선택합니다.
  • 타이틀 설정을 선택합니다.
  • API 기능을 선택합니다.
  • 게시자 IDAPI ACCESS 섹션에 표시됩니다.

title

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

참고 항목

이 엔터티에 대한 변경 내용은 실시간으로 반영되지 않습니다.

ID 필드를 게임의 타이틀 ID로 설정합니다. 타이틀 ID를 검색하는 방법:

  • 게임 관리자에 로그인합니다.
  • 게임 관리자의 왼쪽 상단 모서리에서 기어 아이콘을 선택합니다.
  • 타이틀 설정을 선택합니다.
  • API 기능을 선택합니다.
  • 타이틀 IDAPI ACCESS 섹션에 표시됩니다.

master_player_account

master_player_account은(는) 스튜디오 내의 모든 타이틀에서 공유하는 플레이어 엔터티입니다.

클래식 API에서 ID 필드를 LoginResult.PlayFabId(으)로 설정합니다. LoginResult을(를) 검색하려면 클라이언트 인증에 있는 로그인 방법 중 하나를 호출합니다.

title_player_account

대다수 개발자에게 title_player_account은(는) 가장 일반적으로 플레이어를 표시하는 방식입니다.

클라이언트 API에서 ID 필드를 LoginResult.EntityToken.Entity.Id(으)로 또는 인증 API에서 GetEntityTokenResponse.Entity.Id(으)로 설정합니다.

LoginResult을(를) 검색하려면 클라이언트 인증에 있는 로그인 방법 중 하나를 호출합니다. GetEntityTokenResponse을(를) 검색하려면 엔터티 토큰 가져오기를 호출합니다.

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 기능을 지원하기 위해 향후 시나리오가 추가될 수 있습니다.

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

game_server 엔터티로 인증하려면 타이틀 엔터티로 AuthenticateGameServerWithCustomId API를 호출하고 game_server 엔터티 키와 토큰 쌍을 검색합니다. PFMultiplayerSetEntityToken으로 PlayFab 멀티 플레이어 SDK를 사용할 경우 이 엔터티 키를 사용합니다.