Instance Method

selectChallengeablePlayerIDs(_:withCompletionHandler:)

Finds the subset of players that can earn an achievement.

Declaration

func selectChallengeablePlayerIDs(_ playerIDs: [String]?, withCompletionHandler completionHandler: (([String]?, Error?) -> Void)? = nil)

Parameters

playerIDs

An array of NSString objects containing a list of players. The list of players is used to find those players that are eligible to earn the achievement.

completionHandler

A block to be called when the download is completed.

The block receives the following parameters:

challengeablePlayerIDs

An array of player identifiers representing the players in the original array that are able to complete the challenge. If an error occurred, this parameter may be non-nil, in which case the array holds whatever achievement information Game Kit was able to fetch.

error

If an error occurred, this object describes the error. If the operation completed successfully, this value 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.

See Also

Deprecated Methods and Properties

func challengeComposeController(withPlayers: [String]?, message: String?, completionHandler: GKChallengeComposeCompletionBlock?) -> UIViewController?

Provides a challenge compose view controller with pre-selected player identifiers and a message.

Deprecated
var isHidden: Bool

A Boolean value that states whether this achievement is normally kept secret from the player.

Deprecated
init(identifier: String?, forPlayer: String)

Initializes an achievement for a specific player.

Deprecated
func issueChallenge(toPlayers: [String]?, message: String?)

Issue an achievement challenge to a list of players.

Deprecated
var playerID: String

A string used to identify the player who earned the achievement.

Deprecated
func report(completionHandler: ((Error?) -> Void)?)

Reports the player’s progress to Game Center.

Deprecated