Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

GKGameCenterViewControllerMBS class

Super class: NSViewControllerMBS

Type Topic Plugin Version macOS Windows Linux Console & Web iOS
class GameKit MBS MacFrameworks Plugin 13.0 Yes No No Yes, macOS only No
Function: The GKGameCenterViewControllerMBS class aggregates many common Game Center features into a single user interface.
Notes:
It replaces GKAchievementViewControllerMBS and GKLeaderboardViewControllerMBS as the preferred way to show Game Center content in your game.

Important: Your application must authenticate a local player before you can use any Game Center classes. If there is no authenticated player, your application receives a GKErrorNotAuthenticated error. For more information on authentication, see Game Center Programming Guide.

To display the Game Center screen, initialize a new GKGameCenterViewController object and set its delegate. Optionally, you can choose to configure the view controller further to specify which content is initially displayed. Then present the view controller. Your delegate is called when the user dismisses the screen.

Your game should pause other activities before presenting the Game Center user interface.

Available on Mac OS X 10.8.2 and newer.
Subclass of the NSViewControllerMBS class.

Feedback, Comments & Corrections

State Values

Constant Value Description
StateAchievements 1 Indicates that the view controller presents achievements content.
Available on Mac OS X 10.8.2 and newer.
StateChallenges 2 Indicates that the view controller presents challenges content.
Available on Mac OS X 10.8.2 and newer.
StateDefault -1 Indicates that the view controller should present the default screen.
Available on Mac OS X 10.8.2 and newer.
StateLeaderboards 0 Indicates that the view controller presents leaderboard content. The leaderboardCategory and leaderboardTimeScope properties affect the appearance of this view state.
Available on Mac OS X 10.8.2 and newer.

Super class NSViewControllerMBS

Edge Constants

Constant Value Description
NSMaxXEdge 2 the maximum X edge. Typically right side.
NSMaxYEdge 3 The maximum Y edge. Topically the top edge of a window.
NSMinXEdge 0 the minimum X edge. Typically left side.
NSMinYEdge 1 Minimum Y. As coordinates are upside down in the Cocoa world, this is the bottom edge of a window.

Behavior modes

Constant Value Description
PopoverBehaviorApplicationDefined 0 Your application assumes responsibility for closing the popover. AppKit will still close the popover in a limited number of circumstances. For instance, AppKit will attempt to close the popover when the window of its positioningView is closed. The exact interactions in which AppKit will close the popover are not guaranteed. You may consider implementing -cancel: to close the popover when the escape key is pressed.
PopoverBehaviorSemitransient 2 AppKit will close the popover when the user interacts with user interface elements in the window containing the popover's positioning view. Semi-transient popovers cannot be shown relative to views in other popovers, nor can they be shown relative to views in child windows. The exact interactions that cause semi-transient popovers to close are not specified.
PopoverBehaviorTransient 1 AppKit will close the popover when the user interacts with a user interface element outside the popover. Note that interacting with menus or panels that become key only when needed will not cause a transient popover to close. The exact interactions that will cause transient popovers to close are not specified.

Super class NSResponderMBS

This class has no sub classes.


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


GKFriendRequestComposeViewControllerMBS   -   GKInviteMBS




Links
MBS Xojo blog