123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131 |
- // Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
- //
- // You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
- // copy, modify, and distribute this software in source code or binary form for use
- // in connection with the web services and APIs provided by Facebook.
- //
- // As with any software that integrates with the Facebook platform, your use of
- // this software is subject to the Facebook Developer Principles and Policies
- // [http://developers.facebook.com/policy/]. This copyright notice shall be
- // included in all copies or substantial portions of the software.
- //
- // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
- // FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
- // COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
- // IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
- // CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- #import <Foundation/Foundation.h>
- #import <FBSDKCoreKit/FBSDKCopying.h>
- /*!
- @typedef NS_ENUM(NSUInteger, FBSDKGameRequestActionType)
- @abstract Additional context about the nature of the request.
- */
- typedef NS_ENUM(NSUInteger, FBSDKGameRequestActionType)
- {
- /*! No action type */
- FBSDKGameRequestActionTypeNone = 0,
- /*! Send action type: The user is sending an object to the friends. */
- FBSDKGameRequestActionTypeSend,
- /*! Ask For action type: The user is asking for an object from friends. */
- FBSDKGameRequestActionTypeAskFor,
- /*! Turn action type: It is the turn of the friends to play against the user in a match. (no object) */
- FBSDKGameRequestActionTypeTurn,
- };
- /*!
- @typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilters)
- @abstract Filter for who can be displayed in the multi-friend selector.
- */
- typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilter)
- {
- /*! No filter, all friends can be displayed. */
- FBSDKGameRequestFilterNone = 0,
- /*! Friends using the app can be displayed. */
- FBSDKGameRequestFilterAppUsers,
- /*! Friends not using the app can be displayed. */
- FBSDKGameRequestFilterAppNonUsers,
- };
- /*!
- @abstract A model for a game request.
- */
- @interface FBSDKGameRequestContent : NSObject <FBSDKCopying, NSSecureCoding>
- /*!
- @abstract Used when defining additional context about the nature of the request.
- @discussion The parameter 'objectID' is required if the action type is either
- 'FBSDKGameRequestSendActionType' or 'FBSDKGameRequestAskForActionType'.
- @seealso objectID
- */
- @property (nonatomic, assign) FBSDKGameRequestActionType actionType;
- /*!
- @abstract Compares the receiver to another game request content.
- @param content The other content
- @return YES if the receiver's values are equal to the other content's values; otherwise NO
- */
- - (BOOL)isEqualToGameRequestContent:(FBSDKGameRequestContent *)content;
- /*!
- @abstract Additional freeform data you may pass for tracking. This will be stored as part of
- the request objects created. The maximum length is 255 characters.
- */
- @property (nonatomic, copy) NSString *data;
- /*!
- @abstract This controls the set of friends someone sees if a multi-friend selector is shown.
- It is FBSDKGameRequestNoFilter by default, meaning that all friends can be shown.
- If specify as FBSDKGameRequestAppUsersFilter, only friends who use the app will be shown.
- On the other hands, use FBSDKGameRequestAppNonUsersFilter to filter only friends who do not use the app.
- @discussion The parameter name is preserved to be consistent with the counter part on desktop.
- */
- @property (nonatomic, assign) FBSDKGameRequestFilter filters;
- /*!
- @abstract A plain-text message to be sent as part of the request. This text will surface in the App Center view
- of the request, but not on the notification jewel. Required parameter.
- */
- @property (nonatomic, copy) NSString *message;
- /*!
- @abstract The Open Graph object ID of the object being sent.
- @seealso actionType
- */
- @property (nonatomic, copy) NSString *objectID;
- /*!
- @abstract An array of user IDs, usernames or invite tokens (NSString) of people to send request.
- @discussion These may or may not be a friend of the sender. If this is specified by the app,
- the sender will not have a choice of recipients. If not, the sender will see a multi-friend selector
- This is equivalent to the "to" parameter when using the web game request dialog.
- */
- @property (nonatomic, copy) NSArray *recipients;
- /*!
- @abstract An array of user IDs that will be included in the dialog as the first suggested friends.
- Cannot be used together with filters.
- @discussion This is equivalent to the "suggestions" parameter when using the web game request dialog.
- */
- @property (nonatomic, copy) NSArray *recipientSuggestions;
- /*!
- @deprecated Use `recipientSuggestions` instead.
- */
- @property (nonatomic, copy) NSArray *suggestions __attribute__ ((deprecated("use recipientSuggestions instead")));
- /*!
- @abstract The title for the dialog.
- */
- @property (nonatomic, copy) NSString *title;
- /*!
- @deprecated Use `recipients` instead.
- */
- @property (nonatomic, copy) NSArray *to __attribute__ ((deprecated("use recipients instead")));
- @end
|