기술 자료

Development

User Acquisition

Monetization

산업 분야

Leaderboards

Unity SDK

Admin API

Client API

Open Unity Dashboard

Leaderboards

이 페이지는 선택한 언어로 제공되지 않습니다.
LiveOps
​
​
Leaderboards
  • Overview
  • Get started
  • Concepts
  • Tutorials
    • Configuration
    • Unity SDK tutorial
      • Add a new score
      • Get the player's score
      • Get scores
      • Get a range of scores centered around the player
      • Get scores for other players
      • Get scores for a certain tier
      • Get a list of available leaderboard versions
      • Get the player's score from a leaderboard version
      • Get scores from a leaderboard version
      • Get a range of scores centered around the player from a leaderboard version
      • Get scores for other players from a leaderboard version
      • Get scores for a certain tier from a leaderboard version
    • Unity SDK sample
    • Cloud Code samples
  • Reference
  • Privacy and consent
  1. Leaderboards
  2. Unity SDK tutorial

Get scores for a certain tier

Retrieve scores filtered by a specific tier.
읽는 시간 1분
최근 업데이트: 9달 전

참고
This method fails when your leaderboard is not configured with tiers. When you retrieve scores by tier, the returned
LeaderboardEntry
response tiers are contextual to the rank. For example, if a rank named Silver starts at rank 100 and a player’s global rank is 101, their rank within the Silver tier is 1.
Get the scores for a certain tier with the
GetScoresByTierAsync
method. By default this method returns the top 10 scores from the specified tier:
public async void GetScoresByTier(string leaderboardId){ var scoresResponse = await LeaderboardsService.Instance .GetScoresByTierAsync(leaderboardId, "silver"); Debug.Log(JsonConvert.SerializeObject(scoresResponse));}
Paginated access to all scores within the tier is available by specifying the optional
GetScoresByTierOptions
object with the optional
Offset
and
Limit
pagination arguments.
Offset
is the number of entries to skip when retrieving the leaderboard scores and defaults to 0.
Limit
is the number of leaderboard scores to return and defaults to 10.
C#:
public async void GetPaginatedScoresByTier(string leaderboardId){ var scoresResponse = await LeaderboardsService.Instance.GetScoresByTierAsync( leaderboardId, "silver", new GetScoresByTierOptions{ Offset = 25, Limit = 50 } ); Debug.Log(JsonConvert.SerializeObject(scoresResponse));}
참고
Metadata is not retrieved by default.
To get the score with any associated metadata, use the
IncludeMetadata
option on the
GetScoresByTierOptions
configuration object:
C#:
public async void GetScoresByTierWithMetadata(string leaderboardId){ var scoresResponse = await LeaderboardsService.Instance .GetScoresByTierAsync( leaderboardId, "silver", new GetScoresByTierOptions { IncludeMetadata = true }); Debug.Log(JsonConvert.SerializeObject(scoresResponse));}
참고
For methods that retrieve scores: if your player has not submitted a score and the leaderboard is bucketed, the player is not assigned a bucket. A failed score retrieval returns an error that has its
Reason
field set to
ScoreSubmissionRequired
.

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.


    이 페이지의 문제 보고
    ​
    ​