Tasks

•   delegate

  Set your delegate that should receive the KKGameKitHelperProtocol messages.

  property
•   isGameCenterAvailable

  Check this to see if Game Center is supported on the current Device. See: http://support.apple.com/kb/HT4314

  property
•   lastError

  If your delegate receives an error message, you can check this property for the actual NSError object. This allows you to print out the cause of the error to console log or display an Alert view.

  property
•   achievements

  The cached achievements of the local player. GameKitHelper will save the achievements between sessions to ensure that achievements are updated on Game Center on next app start even if connection was lost.

  property
•   currentMatch

  The current match object. May be nil if there’s no match.

  property
•   matchStarted

  Indicates whether the current match has already started.

  property
• + sharedGameKitHelper

  returns the singleton object, like this: [KKGameKitHelper sharedGameKitHelper]

• – authenticateLocalPlayer

  try to authenticate the local player

• – getLocalPlayerFriends

  request the local player’s friends

• – getPlayerInfo:

  requests info about a set of players

• – submitScore:category:

  submit a score to Game Center

• – retrieveScoresForPlayers:category:range:playerScope:timeScope:

  request the scores of a set of players, in a given category, range and scopes

• – retrieveTopTenAllTimeGlobalScores

  convenience method, requests the Top 10 all time global highscores

• – getAchievementByID:

  returns a cached achievement by its identifier

• – reportAchievementWithID:percentComplete:

  Send an achievement update to Game Center. The message will only be sent if completion percent is greater than any percent previously submitted (Game Center does not allow achievements to regress and would simply ignore such a message).

• – resetAchievements

  Resets all achievement progress. Be very careful with this, should only be run after the player has understood the consequences. You’ll use it rather often during development however. It will also clean all cached achievements.

• – reportCachedAchievements

  Try to send any cached Achievements to Game Center. If updating an achievement fails for any reason, the achievement is cached. By default, GameKitHelper will call this method when the local player is authenticated, so that any previously gained achievements are hopefully sent the next time the player runs the App.

• – saveCachedAchievements

  Saves all cached achievements to persist them between sessions. By default every time an achievement is cached the cached achievements are saved to disk, so they also persist even when the App crashes.

• – loadAchievements

  Starts obtaining the local player’s achievements from Game Center.

• – disconnectCurrentMatch

  Disconnect from the current match

• – setupMatchInvitationHandlerWithMinPlayers:maxPlayers:

  creates the handler for processing match invitations from other players

• – findMatchForRequest:

  Request a match for the given request.

• – addPlayersToMatch:

  Request to add players to a match.

• – cancelMatchmakingRequest

  Cancels any matchmaking request currently in progress.

• – queryMatchmakingActivity

  Request the matchmaking activity to get an indicator on how many games are played.

• – sendDataToAllPlayers:

  sends the given NSData to all players (unreliably)

• – sendDataToAllPlayers:reliable:

  sends the given NSData to all players either reliably (safe but slow) or unreliably (arrival not guaranteed, but fast)

• – sendDataToAllPlayers:length:

  sends the given pointer with the given length to all players (unreliably)

• – sendDataToAllPlayers:length:reliable:

  sends the given pointer with the given length to all players either reliably (safe but slow) or unreliably (arrival not guaranteed, but fast)

• – showLeaderboard

  Brings up the Game Center Leaderboard view.

• – showAchievements

  Brings up the Game Center Achievements view.

• – showMatchmakerWithInvite:

  Brings up the Game Center Matchmaking view after receiving an invite.

• – showMatchmakerWithRequest:

  Brings up the Game Center Matchmaking view with a match request.