Instance Method

setDefaultLeaderboardCategoryID:completionHandler:

Sets the category identifier for the local player’s default leaderboard.

Declaration

- (void)setDefaultLeaderboardCategoryID:(NSString *)categoryID completionHandler:(void (^)(NSError *error))completionHandler;

Parameters

categoryID

The category ID string for one of your game’s leaderboards.

completionHandler

A block to be called when the request completes.

The block receives the following parameter:

error

If an error occurred, this parameter holds an error object that explains the error. Otherwise, the value of this parameter is nil.

Discussion

When this method is called, it creates a new background task to handle the request. The method then returns control to your game. Later, when the task is complete, Game Kit calls your completion handler. The completion handler is always called on the main thread.

The default leaderboard is configured in App Store Connect as part of configuring your game’s leaderboards. All players normally start with this leaderboard as the default leaderboard. Calling this method changes the default leaderboard only for the local player.

See Also

Deprecated Methods and Properties

- authenticateWithCompletionHandler:

Authenticates the local player on the device.

Deprecated
friends

An array of NSString objects containing the player identifiers for the local player’s friends.

Deprecated
- loadDefaultLeaderboardCategoryIDWithCompletionHandler:

Loads the category identifier for the local player’s default leaderboard.

Deprecated
- loadFriendPlayersWithCompletionHandler:

Retrieves a list of player identifiers for the local player’s friends.

Deprecated
- loadFriendsWithCompletionHandler:

Retrieves a list of player identifiers for the local player’s friends.

Deprecated