Class

GKLeaderboardSet

An object that organizes leaderboards into logical and coherent groups.

Declaration

@interface GKLeaderboardSet : NSObject

Overview

A GKLeaderboardSet object is used to read data from a leaderboard set stored on Game Center. Your game uses GKLeaderboardSet objects when it wants to retrieve localized information about a specific leaderboard set or to retrieve scores from a leaderboard set. Typically, you do this when you want the data needed to implement your own custom leaderboard set user interface.

After incorporating leaderboard sets into your app, you must put all of your leaderboards into a set. Individual leaderboards can be put into multiple leaderboard sets and given different display names in each set.

During the development process, you create the leaderboard sets for your game in App Store Connect.

To retrieve information about the available leaderboards for the current set, use the loadLeaderboardsWithCompletionHandler: class method.

To retrieve information about the available leaderboard sets, use the loadLeaderboardSetsWithCompletionHandler: class method.

To retrieve information about the image associated with a leaderboard set, use the loadImageWithCompletionHandler: class method.

Topics

Loading the Leaderboard Sets

- loadImageWithCompletionHandler:

Load the image associated with the leaderboard set.

+ loadLeaderboardSetsWithCompletionHandler:

Load all of the leaderboard sets for the current game.

- loadLeaderboardsWithCompletionHandler:

Load all of the leaderboards for the current leaderboard set.

title

Localized title for the leaderboard set.

identifier

The identifier for the leaderboard set.

groupIdentifier

Identifies the group that the leaderboard set belongs to.

Relationships

Inherits From

See Also

Leaderboards

GKLeaderboard

An object used to read data from a leaderboard stored on Game Center.

GKScore

An object containing information for a score that was earned by the player.