XblLeaderboardQuery
이벤트 기반 또는 타이틀 기반 통계를 사용하여 순위표 쿼리를 제출하기 위한 매개 변수를 나타냅니다.
구문
typedef struct XblLeaderboardQuery {
uint64_t xboxUserId;
char scid[XBL_SCID_LENGTH];
const char* leaderboardName;
const char* statName;
XblSocialGroupType socialGroup;
const char** additionalColumnleaderboardNames;
size_t additionalColumnleaderboardNamesCount;
XblLeaderboardSortOrder order;
uint32_t maxItems;
uint64_t skipToXboxUserId;
uint32_t skipResultToRank;
const char* continuationToken;
XblLeaderboardQueryType queryType;
} XblLeaderboardQuery
멤버
xboxUserId
형식: uint64_t
요청 사용자의 선택적인 Xbox 사용자 ID입니다. 전역 순위표를 수행하는 경우 0으로 설정합니다.
scid
형식: char[XBL_SCID_LENGTH]
타이틀의 UTF-8 인코딩된 SCID(서비스 구성 ID)입니다.
leaderboardName
형식: const char*
순위표를 가져오기 위한 선택적인 UTF-8로 인코딩된 순위표 이름입니다. 만약 소셜 순위표나 타이틀 관리형 통계 지원 순위표를 쿼리하는 경우 nullptr로 설정합니다.
statName
형식: const char*
순위표를 가져오기 위한 선택적인 UTF-8로 인코딩된 통계 이름입니다. 소셜 순위표 또는 타이틀 관리형 통계 지원 순위표를 쿼리할 때 사용됩니다.
socialGroup
형식: XblSocialGroupType
순위표 결과를 가져오기 위한 사용자의 선택적인 소셜 그룹입니다. 예를 들어 "친구만" 포함된 순위표를 가져올 수 있습니다. 전역 순위표를 얻으려면 XblSocialGroupType_None으로 설정합니다.
additionalColumnleaderboardNames
형식: const char**
추가 열에 대한 선택적인 UTF-8로 인코딩된 통계 이름 배열입니다.
additionalColumnleaderboardNamesCount
형식: size_t
전달된 선택적인 additionalColumnleaderboardNames 수입니다.
order
형식: XblLeaderboardSortOrder
결과 순위표에 대한 정렬 순서를 설정합니다.
maxItems
형식: uint32_t
결과 순위표에 포함될 최대 항목을 설정합니다. 서비스가 기본 최대 항목 수를 반환하도록 하려면 0으로 설정합니다.
skipToXboxUserId
형식: uint64_t
결과 순위표가 가운데에 배치할 사용자를 설정합니다. 특정 사용자로 건너뛰지 않으려면 0으로 설정합니다.
skipResultToRank
형식: uint32_t
결과 순위표가 가운데에 배치할 순위를 설정합니다. 특정 순위로 건너뛰지 않으려면 0으로 설정합니다.
continuationToken
형식: const char*
다음 순위표 데이터 집합을 가져오기 위해 사용되는 UTF-8로 인코딩된 continuationToken입니다.
queryType
유형: XblL 순위표 유형
쿼리할 순위표 유형입니다.
멤버
인수
XblLeaderboardGetLeaderboardAsync
설명
이벤트 기반 통계
이벤트 기반 통계와 함께 statName 멤버를 사용하는 경우 값은 통계 인스턴스와 일치해야 합니다.
타이틀 관리 통계
순위표에 타이틀 관리 통계를 사용하는 경우 skipToXboxUserId를 0이 아닌 값으로 설정하면 지정된 xboxUserId의 저장된 통계가 글로벌 순위표와 비교됩니다.
마찬가지로 socialGroup을 사용자 또는 즐겨찾기로 설정하면 지정된 xboxUserId의 저장된 통계가 관련 사용자와 비교됩니다. 전역 순위표의 값은 사용하지 않습니다.
플레이어의 저장된 통계와 글로벌 순위표의 점수가 동일하지 않으면 출력이 일치하지 않을 수 있습니다.
요구 사항
헤더: leaderboard_c.h