Mac Developer Library

Developer

GameKit Framework Reference GKFriendRequestComposeViewController Class Reference

Options
Deployment Target:

On This Page
Language:

GKFriendRequestComposeViewController

Your game uses the GKFriendRequestComposeViewController class to present a screen that allows the local player to send friend requests to other players.

To show a friend request, initialize a new GKFriendRequestComposeViewController object and set the delegate. Optionally, you can customize the request by adding a text message or a list of recipients. Then, present the new view controller and wait for the delegate to be called. Once the delegate is called, dismiss the view controller.

On iOS, you present and dismiss the view controller from another view controller in your game, using the methods provided by the UIViewController class. On OS X, you use the GKDialogController class to present and dismiss the view controller.

Subclassing Notes

The GKFriendRequestComposeViewController class is not intended to be subclassed.

Inheritance


Import Statement


Swift

import GameKit

Objective-C

@import GameKit;

Availability


Available in OS X v10.8 and later.
  • Returns the maximum number of recipients permitted in a single request.

    Declaration

    Swift

    class func maxNumberOfRecipients() -> Int

    Objective-C

    + (NSUInteger)maxNumberOfRecipients

    Return Value

    The maximum number of recipients.

    Discussion

    If you add more recipients than the value returned from this method, Game Kit throws an exception.

    Import Statement

    Objective-C

    @import GameKit;

    Swift

    import GameKit

    Availability

    Available in OS X v10.8 and later.

  • Adds recipients based on their email addresses..

    Declaration

    Swift

    func addRecipientsWithEmailAddresses(_ emailAddresses: [AnyObject]!)

    Objective-C

    - (void)addRecipientsWithEmailAddresses:(NSArray *)emailAddresses

    Parameters

    emailAddresses

    An array with one or more NSString objects, each containing an email address.

    Discussion

    If you do not add at least once recipient, the recipients field is selected when the view controller is presented so that the player can type a list of recipients. Adding more players than defined by the maxNumberOfRecipients property causes an exception to be thrown.

    Import Statement

    Objective-C

    @import GameKit;

    Swift

    import GameKit

    Availability

    Available in OS X v10.8 and later.

  • Adds recipients based on their Game Center player identifiers.

    Declaration

    Swift

    func addRecipientPlayers(_ players: [AnyObject]!)

    Objective-C

    - (void)addRecipientPlayers:(NSArray *)players

    Parameters

    players

    An array with one or more GKPlayer objects, each containing an player identifier.

    Discussion

    If you do not add at least once recipient, the recipients field is selected when the view controller is presented so that the player can type a list of recipients. Adding more players than defined by the maxNumberOfRecipients property causes an exception to be thrown.

    Import Statement

    Objective-C

    @import GameKit;

    Swift

    import GameKit

    Availability

    Available in OS X v10.10 and later.

  • Adds recipients based on their Game Center player identifiers.

    Declaration

    Swift

    func addRecipientsWithPlayerIDs(_ playerIDs: [AnyObject]!)

    Objective-C

    - (void)addRecipientsWithPlayerIDs:(NSArray *)playerIDs

    Parameters

    playerIDs

    An array with one or more NSString objects, each containing an player identifier.

    Discussion

    If you do not add at least once recipient, the recipients field is selected when the view controller is presented so that the player can type a list of recipients.

    Import Statement

    Objective-C

    @import GameKit;

    Swift

    import GameKit

    Availability

    Available in OS X v10.8 and later.

    Deprecated in OS X v10.10.

  • Sets the text message included in the friend invitation.

    Declaration

    Swift

    func setMessage(_ message: String!)

    Objective-C

    - (void)setMessage:(NSString *)message

    Parameters

    message

    The text message.

    Discussion

    If you do not set a text message, Game Kit sets a default text message.

    Import Statement

    Objective-C

    @import GameKit;

    Swift

    import GameKit

    Availability

    Available in OS X v10.8 and later.