Get scores for a certain tier
Retrieve scores filtered by a specific tier.
Read time 1 minuteLast updated 8 months ago
Note
This method fails when your leaderboard is not configured with tiers. When you retrieve scores by tier, the returned 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.
LeaderboardEntryGet the scores for a certain tier with the method. By default this method returns the top 10 scores from the specified tier:
GetScoresByTierAsyncpublic 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 object with the optional and pagination arguments.
GetScoresByTierOptionsOffsetLimitOffsetLimitC#:
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));}
Note
Metadata is not retrieved by default.
To get the score with any associated metadata, use the option on the configuration object:
IncludeMetadataGetScoresByTierOptionsC#:
public async void GetScoresByTierWithMetadata(string leaderboardId){ var scoresResponse = await LeaderboardsService.Instance .GetScoresByTierAsync( leaderboardId, "silver", new GetScoresByTierOptions { IncludeMetadata = true }); Debug.Log(JsonConvert.SerializeObject(scoresResponse));}
Note
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 field set to .
ReasonScoreSubmissionRequired