Platforms to show: All Mac Windows Linux Cross-Platform

Back to GameKitMBS class.

Previous items

GameKitMBS.queryPlayerGroupActivityCompleted(MatchMaker as GKMatchmakerMBS, playerGroup as Integer, activity as Integer, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKMatchmakerMBS.queryPlayerGroupActivity when the search completes.

activity: The amount of activity in the player group.
error: If the search completed successfully, this parameter is nil; otherwise, this parameter holds an error object that describes the error that occurred.

GameKitMBS.receivedTurnEventForMatch(player as GKPlayerMBS, match as GKTurnBasedMatchMBS, didBecomeActive as boolean)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 15.0 ✅ Yes ❌ No ❌ No ❌ No
Activates the player’s turn. (required)

This method is called when the it becomes the player’s turn. It is also called when any of the following events happen:

  • The current turn has a time-out associated with it and the turn is about to expire.
  • Player accepts an invite from another player.
  • Turn was passed to another player. In this case, didBecomeActive is false.
  • Match data is saved by another player.
  • Player receives a reminder.

Available in OS X v10.10 and later.

GameKitMBS.recipientResponseHandler(MatchRequest as GKMatchRequestMBS, Player as GKPlayerMBS, response as Integer, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 15.0 ✅ Yes ❌ No ❌ No ❌ No
This event is called whenever you programmatically invite specific players to join a match.

It is called once for each player invited to the match. Typically, your game uses the responses to update the custom user interface. For example, you want the player to be able to perform any of the following tasks:

  • Start the match.
  • Invite an additional set of specific players.
  • Use matchmaking to fill the remaining match slots.

Available in OS X v10.10 and later.

GameKitMBS.rematchCompleted(TurnMatch as GKTurnBasedMatchMBS, match as GKMatchMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called when GKMatchMBS.rematch completes.

match: The new match. If an error occurred, this parameter's value is nil.
error: If an error occurred, this parameter holds an error object that describes the problem. If the match was successfully recreated, this parameter's value is nil.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.remotePlayerDidCompleteChallenge(challenge as GKChallengeMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called when a non-local player has completed a challenge issued by the local player.

Triggered by a push notification from the server. Received when a challenge notification banner is clicked, or while the game is running.
Available on Mac OS X 10.8.2 and newer.

GameKitMBS.removeCompleted(match as GKTurnBasedMatchMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKTurnBasedMatchMBS.remove on completion.

If an error occurred, this error object describes the error. If the operation was completed successfully, the value is nil.
Tag is the parameter you passed to remove method.

GameKitMBS.reportAchievementCompleted(score as GKAchievementMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKAchievementMBS.reportAchievement after the operation completes.

error: If the operation was successful, this value is nil; otherwise, this parameter holds an object that describes the problem that occurred.

GameKitMBS.reportAchievementsCompleted(achievements() as GKAchievementMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called when GKAchievementMBS.reportAchievements completes.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.reportScoreCompleted(score as GKScoreMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKScoreMBS.reportScore after the score is reported.

error: If an error occurred, this parameter holds an error object that describes the problem. If the score was successfully reported, this parameter's value is nil.

GameKitMBS.reportScoresCompleted(Scores() as GKScoreMBS, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Reporting scores completed.

scores: An array of score objects to report to Game Center.
error: If an error occurred, this parameter holds an error object that describes the problem. If the score was successfully reported, this parameter's value is nil.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.resetAchievementsCompleted(error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKAchievementMBS.resetAchievements when the reset action is completed.

error: If the operation was successful, this value is nil; otherwise, this parameter holds an object that describes the problem that occurred.

GameKitMBS.saveCurrentTurnWithMatchDataCompleted(match as GKTurnBasedMatchMBS, matchData as Dictionary, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
The event to be called after the data is uploaded to Game Center.

error: If an error occurred, this error object describes the error. If the operation was completed successfully, the value is nil.
matchData: The game-specific state for the match.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.selectChallengeablePlayerIDsCompleted(Achievement as GKAchievementMBS, playerIDs() as string, challengeablePlayerIDs() as string, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called by GKAchievementMBS.selectChallengeablePlayerIDs on completion

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.setDefaultLeaderboardCategoryIDCompleted(LocalPlayer as GKLocalPlayerMBS, categoryID as string, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called by GKLocalPlayerMBS.setDefaultLeaderboardCategoryID when completed.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.setDefaultLeaderboardCompleted(categoryID as string, error as NSErrorMBS, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called by GKLeaderboardMBS.setDefaultLeaderboard after the scores are retrieved from the server.

error: If an error occurred, this error object describes the error. If the operation was completed successfully, the value is nil.

GameKitMBS.shouldShowBannerForLocallyCompletedChallenge(challenge as GKChallengeMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Whether to show banner for locally completed challenge.

If the method returns true, a challenge banner (like an achievement or welcome banner -- not a notification center banner) is displayed. If false, then no banner is displayed. Default behavior for non-implementing apps is true.
Available on Mac OS X 10.8.2 and newer.

GameKitMBS.shouldShowBannerForLocallyReceivedChallenge(challenge as GKChallengeMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Whether to show banner for locally received challenge.

If the method returns true, a challenge banner (like an achievement or welcome banner -- not a notification center banner) is displayed when a challenge is received in-game for the local player. If false, then no banner is displayed, and localPlayerDidSelectChallenge will not be called for that challenge. Default behavior for non-implementing apps is true.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.shouldShowBannerForRemotelyCompletedChallenge(challenge as GKChallengeMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Whether to show banner for remotely completed challenge.

If the method returns true, a challenge banner (like an achievement or welcome banner -- not a notification center banner) is displayed. If false, then no banner is displayed. Default behavior for non-implementing apps is true.
Available on Mac OS X 10.8.2 and newer.

GameKitMBS.startBrowsingForNearbyPlayersCompleted(Matchmaker as GKMatchmakerMBS, playerID as string, reachable as boolean, tag as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 13.0 ✅ Yes ❌ No ❌ No ❌ No
Called when startBrowsingForNearbyPlayers method found a player.

Available on Mac OS X 10.8.2 and newer.

GameKitMBS.turnBasedMatchmakerViewControllerDidFailWithError(viewController as Variant, error as NSErrorMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called when an error occurs. (required)

viewController: The view controller that received an error. (GKTurnBasedMatchmakerViewControllerMBS)
error: An error object that describes the error.

Your game should dismiss the view controller.

GameKitMBS.turnBasedMatchmakerViewControllerDidFindMatch(viewController as Variant, match as GKTurnBasedMatchMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called when the player selected a match to view. (required)

viewController: The view controller that found a match. (GKTurnBasedMatchmakerViewControllerMBS)
match: The match that the player selected.

Your game should dismiss the view controller and use the match object to show the current state of the match to the player.

GameKitMBS.turnBasedMatchmakerViewControllerPlayerQuitForMatch(viewController as Variant, match as GKTurnBasedMatchMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called when a player chooses to quit the match. (required)

viewController: The view controller that the player interacted with. (GKTurnBasedMatchmakerViewControllerMBS)
match: The match the player has chosen to quit.

When this method is called, the player is the current participant in the match, but that player has chosen to resign the match instead of taking a turn. Your game should dismiss the view controller, set an outcome for the player, and then call the match's participantQuitInTurnWithOutcome method.

GameKitMBS.turnBasedMatchmakerViewControllerWasCancelled(viewController as Variant)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event GameKit MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No
Called when the player cancels matchmaking. (required)

viewController: The view controller that the player canceled. (GKTurnBasedMatchmakerViewControllerMBS)

Your game should dismiss the view controller.

Previous items

The items on this page are in the following plugins: MBS MacFrameworks Plugin.


💬 Ask a question or report a problem
The biggest plugin in space...