Skip to main content
이 항목에서는 순위표가 게임에 대한 선택된 통계를 표시하여 플레이어를 비교하는 방법을 설명합니다. 순위표는 플레이어들을 몰입시키고 그들 사이의 경쟁을 유도하는 재미있는 방법입니다. XBOX services는 하드코어 플레이어(전체 XBOX 사용자에 대한 전역 순위)와 캐주얼 플레이어(플레이어의 친구에 대한 소셜 순위)에게 적합한 기능을 제공합니다. 전역과 소셜의 두 가지 유형의 순위표를 사용할 수 있습니다. 개념은 매우 유사하지만 구성 및 목적 측면에서 근본적인 차이가 있습니다.

전역 vs. 소셜 순위표

전역 순위표

  • 전역 순위표는 전체 XBOX 사용자 기반의 순위를 매기며 구성해야 합니다.
  • 전역 순위표는 수집 시점(타이틀이 릴리스되기 전 또는 릴리스 후 언제든지)에 서비스에서 구성하는 사전 정의된 뷰입니다.

소셜 순위표

  • 소셜 순위표는 동적으로 생성되며 플레이어의 친구 순위를 매깁니다.
  • 소셜 순위표에는 플레이어의 소셜 그래프에 있는 플레이어만 포함됩니다.
  • 소셜 순위표는 서비스가 기존 사용자 통계를 기반으로 런타임에 동적으로 순위표를 생성하기 때문에 수집 시점에 사전 정의할 필요가 없습니다.

순위표 이해

순위표에는 두 가지 주요 구성 요소가 있습니다.
  • 순위 지정 값(XBOX services에서 이것은 항상 플레이어 통계 인스턴스입니다).
  • 정렬 순서(높은 값 또는 낮은 값이 더 좋음).

순위 값으로서의 통계

순위표는 플레이어 통계에서 파생됩니다. 필요한 것에 대해 올바른 통계 규칙을 정의하는 것이 중요합니다. 게임을 디자인할 때 플레이어를 순위에 매기고 싶은 순위표를 염두에 두세요.

전역 순위표

전역 순위표는 XBOX 커뮤니티 전반의 플레이어가 기록한 최고 점수를 추적합니다. 전역 순위표의 주요 차별화 요소는 순위표 식별 이름, 순위 통계, 정렬 순서(오름차순 또는 내림차순)를 지정하여 수집 시점에 사전 정의된다는 점입니다. 타이틀은 무제한 수의 전역 순위표를 정의할 수 있으며 서비스 구성을 통해 언제든지 순위표를 추가할 수 있습니다. 현재 전역 순위표당 최대 레코드 수는 10,000개 항목으로 제한됩니다. 즉, “최고” 점수가 상위 10,000위 안에 들지 못한 플레이어의 점수는 순위표에 표시되지 않습니다. 한 번에 최대 100개의 순위표 항목(플레이어 XUID, 게이머태그, 전역 순위, 점수)의 “페이지”를 읽고 페이지의 시작 순위를 지정하거나 지정된 게이머태그를 중심으로 한 순위표 항목을 가져올 수 있습니다. 결과는 항상 전체 기간에 한정되며 일간, 주간, 월간 뷰는 아직 지원되지 않습니다. 전역 순위표는 XBOX Services API(XSAPI) 또는 REST API를 통해 GET (/scids/{scid}/leaderboards/{leaderboardname})을 사용하여 액세스할 수 있습니다. 레이싱 게임에 대한 샘플 순위표가 어떻게 구성될 수 있는지에 대한 스크린샷은 다음과 같습니다. 순위표 이름이 FastestLap인 순위표 세부 UI의 스크린샷. 정렬 순서는 낮은 값이 더 좋음을 보여줍니다.

소셜 순위표

소셜 순위표는 캐주얼 플레이어가 친구와 자신을 비교하고 순위를 매길 수 있는 훌륭한 인센티브입니다. 커뮤니티에서 상위권에 들지 않더라도, 자신이 아는 플레이어를 이기려는 동기를 부여받을 수 있습니다. 소셜 순위표는 기존 사용자 통계를 기반으로 동적으로 생성됩니다. 결과적으로 수집 시점에 사전 정의될 필요가 없으며 특정 플레이어 한 명의 소셜 그래프에 있는 플레이어만 포함됩니다. 소셜 순위표의 주요 장점은 사전 정의되지 않는다는 것입니다. 게임의 모든 통계에 대해 소셜 순위표를 만들 수 있습니다. 호출자는 소셜 순위표를 요청할 때 두 가지를 지정할 수 있습니다. 즉, 통계 인스턴스와 정렬 순서(기본값은 등급별 내림차순)입니다. 결과는 항상 전체 기간에 한정되며 일간, 주간, 월간 뷰는 지원되지 않습니다. 전역 순위표와 마찬가지로 호출자는 한 번에 최대 100개의 순위표 항목(플레이어 XUID, 게이머태그, 전역 순위, 점수)의 “페이지”를 읽고 페이지의 시작 순위를 지정할 수 있습니다. 소셜 순위표는 XSAPI 또는 REST API를 통해 GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})를 사용하여 액세스합니다.

소셜 뷰가 있는 전역 순위표

소셜 순위표는 동적으로 생성되기 때문에 전역 순위표보다 검색하는 데 더 오래 걸립니다. 타이틀이 공통 기준 세트를 기반으로 자주 소셜 순위표를 검색하는 시나리오의 경우 전역 순위표를 만들고 플레이어의 소셜 그래프와 관련된 순위표의 항목만 검색할 수 있습니다. 이렇게 하면 순위표가 이미 XBOX services 서버에 존재하기 때문에 소셜 순위표보다 검색 시간이 빨라집니다. 또한 결과가 사용자의 소셜 그래프에 한정되므로 페이로드도 작아집니다. 이 유형의 순위표는 전역 순위표입니다. 따라서 타이틀의 서비스 구성에 정의해야 합니다. 소셜 뷰가 있는 전역 순위표는 일반 전역 순위표 요청 GET (/scids/{scid}/leaderboards/{leaderboardname})을 사용하고 URL에 &viewTarget=people&view=people 쿼리를 추가하여 액세스합니다. 다중 열 순위표 뷰를 지원하려면 통계 메타데이터를 사용할 수 있습니다. 타이틀은 순위표 통계에 대한 메타데이터 필드를 정의할 수 있으며, 이 필드는 순위표 순위를 쿼리할 때 반환될 수 있습니다. 개인정보 보호 설정으로 인해 통계 액세스가 방지될 수 있으므로 타이틀은 동일한 동작을 얻기 위해 일괄 사용자 통계 URI를 사용해서는 안 됩니다.

다중 열 순위표

통계에 더 많은 정보를 제공하기 위해 순위표에 더 많은 열이 필요한 경우가 있을 것입니다. 예를 들어 가장 많이 물리친 적에 대한 순위표의 경우 플레이어가 사용한 무기, 발생한 맵, 가장 많이 물리친 적의 유형, 킬/데스 비율을 추가할 수 있습니다. XBOX 순위표에는 다중 열 지원 기능이 내장되어 있습니다. 이러한 유형의 순위를 쉽게 얻을 수 있습니다. 유일한 전제 조건은 순위표에 사용된 통계에 통계 컨텍스트가 정의되어 있어야 한다는 것입니다. 이것이 추가 메타데이터로 사용될 것입니다. 예를 들어 FastestLap 통계의 경우 이러한 추가 속성을 통계 컨텍스트로 구성하고 싶을 수 있습니다. 다음은 그것들이 어떻게 보일 수 있는지에 대한 스크린샷입니다. CarModel, WeatherCondition, TrackId의 통계 컨텍스트 이름이 있는 통계 컨텍스트 UI의 스크린샷. 이제 통계가 컨텍스트와 함께 유지되므로 다중 열 순위표를 검색하면 다음 표와 같이 보일 것입니다. 다중 열 순위표는 현재 전역 순위표 및 소셜 뷰가 있는 전역 순위표에서 지원됩니다. 그러나 다중 열 소셜 순위표를 만들려면 일괄 사용자 통계 호출을 사용하여 컨텍스트와 함께 모든 통계를 가져온 다음 순위표를 수동으로 만들 수 있습니다. 다중 열 순위표는 일반 전역 순위표 요청 GET (/scids/{scid}/leaderboards/{leaderboardname})을 사용하고 URL에 &include=valuemetadata 쿼리를 추가하여 REST API를 통해서만 액세스할 수 있습니다.

주요 통계가 있는 순위표가 표시되는 위치

순위표는 게임에 대한 선택된 통계를 표시하여 플레이어를 비교합니다. 순위표는 플레이어 간의 경쟁을 장려하는 훌륭한 방법입니다. 순위표는 플레이어가 이전 최고 점수 및 친구의 점수를 이기려고 계속 참여하도록 합니다.
  • 주요 통계에 대한 순위표는 항상 타이틀의 공식 클럽에 표시됩니다.
  • 주요 통계에 대한 순위표는 때때로 플레이어 프로필의 업적 뷰와 같은 다른 XBOX 경험에 표시됩니다.
  • 또한 구성된 주요 통계를 사용하여 타이틀 내부에 순위표를 만들 수 있습니다.

좋은 순위표 선택하기

순위표는 정의한 통계에 해당합니다. 플레이어가 개선하기 위해 노력할 수 있는 성과에 해당하는 순위표를 선택해야 합니다. 예를 들어 레이싱 게임의 최고 랩 타임은 플레이어가 최고 랩 타임을 개선하기 위해 노력하려고 하기 때문에 좋은 순위표입니다. 다른 예로는 슈터의 킬/데스 비율이나 격투 게임의 최대 콤보 크기가 있습니다.

순위표를 표시하는 시점

타이틀에서 언제든지 순위표를 표시할 수 있습니다. 순위표가 게임 플레이나 타이틀의 흐름을 방해하지 않는 시간을 선택해야 합니다. 예를 들어 라운드 사이와 경기 후는 순위표를 표시하기에 좋은 시간입니다.

프로그래밍 가이드

순위표의 현재 상태를 얻기 위해 사용할 수 있는 여러 순위표 API가 있습니다. 모든 API는 비동기이며 차단하지 않습니다. 순위표 데이터를 가져오기 위한 요청을 하고 평소 게임 처리를 계속하세요. 서비스에서 순위표 결과가 반환되면 적절한 시간에 결과를 표시할 수 있습니다. 표시하려는 시점보다 약간 앞서 서비스에서 순위표 데이터를 요청하세요. 이렇게 하면 플레이어가 순위표가 표시되기를 기다리는 동안 차단되는 것을 방지할 수 있습니다.

참고 항목

이벤트 기반 통계 vs. 타이틀 관리 통계.
마지막 수정일 2026년 8월 25일