Skip to main content
Class: SummerClientRatings · Inherits: RefCounted · Access: Summer.client.ratings This player’s own match results and committed account ratings. Two facts converge here and game code never has to relay either. When the authority concludes a Match, the Engine delivers this Session’s outcome as a SummerMatchResult with a pending rating and emits match_result. When the platform commits the rating, the trusted Player Host delivers it privately to this player alone; the same result moves to committed and rating_committed fires. Stale or replayed facts never overwrite newer state, and no other player’s result or rating is ever visible here. Recovery after a missed delivery is refresh(), a bounded read through the Player Host of the same value, games, version triple. Game code never calls the platform directly.

​
Properties

​
Methods

​
get_current

The latest committed rating for queue, or null until one is known. Returns: SummerRatingSnapshot

​
leaderboard

Reads queue’s 50 highest-rated players by display name through the Player Host; SummerLeaderboardEntry.you marks the caller’s own row. Only the Host’s own queue can be read. One read is in flight at a time; a second call for the same queue returns the pending operation. Returns: SummerLeaderboardOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

​
refresh

Reads the committed rating for queue through the Player Host. Only a strictly newer version replaces the held one. One read is in flight at a time; a second call while pending returns the same operation. Fails typed with invalid_argument for an empty queue or unavailable (retryable) when the Player Host cannot be reached. Returns: SummerOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

​
standing

Reads the caller’s own place in queue through the Player Host: their rating, how many players are rated, their percentile once rated, and their leaderboard rank when it is within the top 1000. One read is in flight at a time; a second call for the same queue returns the pending operation. Returns: SummerStandingOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

​
Signals

​
match_result

The authority concluded a Match this player took part in. SummerMatchResult.rating_state is pending or none; no rating values are present yet.

​
rating_changed

The current rating for queue advanced, through a commit, a platform snapshot, or refresh().

​
rating_committed

The platform committed this player’s rating for the Match in result; SummerMatchResult.rating is now set.
What is live on the platform today: platform capability status. Check availability at runtime before you offer a feature.