Skip to main content
PlayFab에서는 일반적으로 다음 API 메서드를 사용하여 리더보드를 구성합니다. 결과는 플레이어에 대한 기본 정보와 현재 리더보드와의 관계만 포함하는 PlayerLeaderboardEntry 개체 목록입니다. 그러나 PlayFab은 PlayerProfileViewConstraints를 사용하여 각 플레이어에 대한 추가 정보를 얻을 수 있게 해줍니다.
이 예시에서는 이미 다뤄볼 수 있는 리더보드 데이터가 있다고 가정합니다. 테스트 데이터를 생성하는 방법은 보관된 토너먼트 결과 액세스 튜토리얼을 참조하세요.

플레이어 프로필 뷰 제약 조건 구성

기본적으로 Client API는 다른 플레이어 프로필에서 display name만 가져올 수 있습니다. 이 예시에서는 모든 플레이어가 리더보드의 다른 플레이어에 대한 추가 정보에 액세스할 수 있도록 허용합니다. 타이틀 Game Manager로 이동합니다.
  1. 왼쪽 메뉴에서 Settings 아이콘을 선택합니다.
  2. Title settings를 선택합니다.
  3. 그런 다음 Client Profile Options 탭을 선택합니다.
  4. DisplayName이 선택되어 있는지 확인합니다.
  5. Avatar URL이 선택되어 있는지 확인합니다.
  6. Save Client Profile Options 버튼을 선택하여 변경 사항을 제출합니다.
Game Manager - Settings - Client Profile Options

테스트

이전 단계에서 클라이언트 코드가 DisplayNameAvatarUrl 프로필 제약 조건을 사용할 수 있게 되었습니다. 다음 샘플은 언급된 프로필 데이터를 사용하여 리더보드를 가져오고 출력하는 방법을 보여줍니다. 자세한 내용은 코드 주석을 참조하세요.
개별 프로필 필드는 클라이언트가 Profile Constraints를 사용하여 명시적으로 요청한 경우에만 사용할 수 있습니다. 또한 Game Manager에서 특정 프로필 제약 조건이 허용되지 않는데 클라이언트가 이를 요청하는 경우, API 호출은 해당 오류와 함께 실패합니다. 결과는 아래 예시와 유사하게 표시됩니다.
Output - Display Leaderboard 이 기법을 사용하여 다른 통계 값을 포함하여 프로필 정보의 일부를 가져올 수 있습니다.
마지막 수정일 2026년 8월 13일