Get a range of scores centered around the player
Retrieve scores for a player and their neighboring competitors.
Read time 1 minuteLast updated 8 months ago
To get the entries of the player as well as the specified number of neighboring players ranked on either side of the player, use the method:
GetPlayerRangeAsyncpublic async void GetPlayerRange(string leaderboardId){ // Returns a total of 11 entries (the given player plus 5 on either side) var rangeLimit = 5; var scoresResponse = await LeaderboardsService.Instance.GetPlayerRangeAsync( leaderboardId, new GetPlayerRangeOptions{ RangeLimit = rangeLimit } ); 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:
IncludeMetadataGetPlayerRangeOptionspublic async void GetPlayerRangeWithMetadata(string leaderboardId){ var scoresResponse = await LeaderboardsService.Instance .GetPlayerRangeAsync( leaderboardId, new GetPlayerRangeOptions() { 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