iOS 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. More...

Inheritance


Import Statement


import GameKit @import GameKit;

Availability


Available in iOS 4.2 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

    import GameKit

    Availability

    Available in iOS 4.2 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

    import GameKit

    Availability

    Available in iOS 4.2 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

    import GameKit

    Availability

    Available in iOS 8.0 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

    import GameKit

    Availability

    Available in iOS 4.2 and later.

    Deprecated in iOS 8.0.

  • 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

    import GameKit

    Availability

    Available in iOS 4.2 and later.