리더보드 버전에서 특정 계층의 점수 가져오기
리더보드가 계층으로 구성되어 있지 않으면 이 메서드는 작동하지 않습니다. 계층별로 점수를 검색하면 반환된 LeaderboardEntry
응답 계층은 순위에 따라 컨텍스트화됩니다. 예를 들어 실버 순위가 100위부터 시작하는데 플레이어의 전체 순위가 101위이면 실버 계층 내에서 플레이어 순위는 1위입니다.
리더보드 버전에서 특정 계층의 점수를 가져오려면 GetVersionScoresByTierAsync
메서드를 사용합니다. 기본적으로 이 메서드는 다음과 같이 지정된 계층에서 상위 10개 점수를 반환합니다.
C#
public async void GetVersionScoresByTier()
{
var versionId = "";
var scoresResponse = await LeaderboardsService.Instance
.GetVersionScoresByTierAsync(leaderboardId, versionId, "silver");
Debug.Log(JsonConvert.SerializeObject(scoresResponse));
}
필요에 따라 Offset
및 Limit
페이지 지정 인수를 포함하여 GetVersionScoresByTierOptions
오브젝트를 지정하면 계층 내에서 페이지가 지정된 방식으로 모든 점수에 액세스할 수 있습니다. Offset
은 리더보드 점수를 검색할 때 건너뛸 수 있는 엔트리 수이며 기본값은 0입니다. Limit
는 반환되는 리더보드 점수 수이며 기본값은 10입니다.
C#
public async void GetPaginatedVersionScoresByTier()
{
var scoresResponse = await LeaderboardsService.Instance.GetVersionScoresByTierAsync(
leaderboardId,
versionId,
"silver",
new GetVersionScoresByTierOptions{ Offset = 25, Limit = 50 }
);
Debug.Log(JsonConvert.SerializeObject(scoresResponse));
}
사용 가능한 리더보드 버전 ID를 가져오는 방법에 대한 내용은 사용 가능한 리더보드 버전 가져오기에서 확인하십시오.
점수를 검색하는 메서드의 경우, 플레이어가 제출한 점수가 없고 리더보드가 버킷에 포함되면 플레이어는 버킷에 할당되지 않습니다. 점수 검색이 실패하면 Reason
필드에 ScoreSubmissionRequired
로 설정된 오류가 반환됩니다.