| | |
|---|
| | | |
|---|
| | | #import <Foundation/Foundation.h> |
|---|
| | | |
|---|
| | | #import <FBSDKCoreKit/FBSDKAccessToken.h> |
|---|
| | | |
|---|
| | | #import <FBSDKShareKit/FBSDKShareOpenGraphObject.h> |
|---|
| | | #import <FBSDKShareKit/FBSDKSharing.h> |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract A utility class for sharing through the graph API. Using this class requires an access token in |
|---|
| | | [FBSDKAccessToken currentAccessToken] that has been granted the "publish_actions" permission. |
|---|
| | | @discussion FBSDKShareAPI network requests are scheduled on the current run loop in the default run loop mode |
|---|
| | | /** |
|---|
| | | A utility class for sharing through the graph API. Using this class requires an access token that |
|---|
| | | has been granted the "publish_actions" permission. |
|---|
| | | |
|---|
| | | FBSDKShareAPI network requests are scheduled on the current run loop in the default run loop mode |
|---|
| | | (like NSURLConnection). If you want to use FBSDKShareAPI in a background thread, you must manage the run loop |
|---|
| | | yourself. |
|---|
| | | */ |
|---|
| | | @interface FBSDKShareAPI : NSObject <FBSDKSharing> |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract Convenience method to build up a share API with content and a delegate. |
|---|
| | | @param content The content to be shared. |
|---|
| | | @param delegate The receiver's delegate. |
|---|
| | | /** |
|---|
| | | Convenience method to build up a share API with content and a delegate. |
|---|
| | | - Parameter content: The content to be shared. |
|---|
| | | - Parameter delegate: The receiver's delegate. |
|---|
| | | */ |
|---|
| | | + (instancetype)shareWithContent:(id<FBSDKSharingContent>)content delegate:(id<FBSDKSharingDelegate>)delegate; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract The message the person has provided through the custom dialog that will accompany the share content. |
|---|
| | | /** |
|---|
| | | The message the person has provided through the custom dialog that will accompany the share content. |
|---|
| | | */ |
|---|
| | | @property (nonatomic, copy) NSString *message; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract The graph node to which content should be shared. |
|---|
| | | /** |
|---|
| | | The graph node to which content should be shared. |
|---|
| | | */ |
|---|
| | | @property (nonatomic, copy) NSString *graphNode; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract A Boolean value that indicates whether the receiver can send the share. |
|---|
| | | @discussion May return NO if the appropriate Facebook app is not installed and is required or an access token is |
|---|
| | | /** |
|---|
| | | The access token used when performing a share. The access token must have the "publish_actions" |
|---|
| | | permission granted. |
|---|
| | | |
|---|
| | | Defaults to [FBSDKAccessToken currentAccessToken]. Setting this to nil will revert the access token to |
|---|
| | | [FBSDKAccessToken currentAccessToken]. |
|---|
| | | */ |
|---|
| | | @property (nonatomic, strong) FBSDKAccessToken *accessToken; |
|---|
| | | |
|---|
| | | /** |
|---|
| | | A Boolean value that indicates whether the receiver can send the share. |
|---|
| | | |
|---|
| | | May return NO if the appropriate Facebook app is not installed and is required or an access token is |
|---|
| | | required but not available. This method does not validate the content on the receiver, so this can be checked before |
|---|
| | | building up the content. |
|---|
| | | @see [FBSDKSharing validateWithError:] |
|---|
| | | @result YES if the receiver can send, otherwise NO. |
|---|
| | | |
|---|
| | | - See:[FBSDKSharing validateWithError:] |
|---|
| | | - Returns: YES if the receiver can send, otherwise NO. |
|---|
| | | */ |
|---|
| | | - (BOOL)canShare; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract Creates an User Owned Open Graph object without an action. |
|---|
| | | @param openGraphObject The open graph object to create. |
|---|
| | | @discussion Use this method to create an object alone, when an action is not going to be posted with the object. If |
|---|
| | | /** |
|---|
| | | Creates an User Owned Open Graph object without an action. |
|---|
| | | - Parameter openGraphObject: The open graph object to create. |
|---|
| | | |
|---|
| | | Use this method to create an object alone, when an action is not going to be posted with the object. If |
|---|
| | | the object will be used within an action, just put the object in the action and share that as the shareContent and the |
|---|
| | | object will be created in the process. The delegate will be messaged with the results. |
|---|
| | | |
|---|
| | | Also see https://developers.facebook.com/docs/sharing/opengraph/object-api#objectapi-creatinguser |
|---|
| | | |
|---|
| | | @result YES if the receiver was able to send the request to create the object, otherwise NO. |
|---|
| | | - Returns: YES if the receiver was able to send the request to create the object, otherwise NO. |
|---|
| | | */ |
|---|
| | | - (BOOL)createOpenGraphObject:(FBSDKShareOpenGraphObject *)openGraphObject; |
|---|
| | | |
|---|
| | | /*! |
|---|
| | | @abstract Begins the send from the receiver. |
|---|
| | | @result YES if the receiver was able to send the share, otherwise NO. |
|---|
| | | /** |
|---|
| | | Begins the send from the receiver. |
|---|
| | | - Returns: YES if the receiver was able to send the share, otherwise NO. |
|---|
| | | */ |
|---|
| | | - (BOOL)share; |
|---|
| | | |
|---|
