| | |
| | | #import <UIKit/UIKit.h> |
| | | |
| | | #import <FBSDKCoreKit/FBSDKCopying.h> |
| | | #import <FBSDKShareKit/FBSDKShareMediaContent.h> |
| | | #import <FBSDKShareKit/FBSDKSharingValidation.h> |
| | | |
| | | /*! |
| | | @abstract A photo for sharing. |
| | | NS_ASSUME_NONNULL_BEGIN |
| | | |
| | | @class PHAsset; |
| | | |
| | | /** |
| | | A photo for sharing. |
| | | */ |
| | | @interface FBSDKSharePhoto : NSObject <FBSDKCopying, NSSecureCoding> |
| | | NS_SWIFT_NAME(SharePhoto) |
| | | @interface FBSDKSharePhoto : NSObject <NSSecureCoding, FBSDKCopying, FBSDKShareMedia, FBSDKSharingValidation> |
| | | |
| | | /*! |
| | | @abstract Convenience method to build a new photo object with an image. |
| | | /** |
| | | Convenience method to build a new photo object with an image. |
| | | @param image If the photo is resident in memory, this method supplies the data |
| | | @param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the |
| | | application |
| | | */ |
| | | + (instancetype)photoWithImage:(UIImage *)image userGenerated:(BOOL)userGenerated; |
| | | |
| | | /*! |
| | | @abstract Convenience method to build a new photo object with an imageURL. |
| | | /** |
| | | Convenience method to build a new photo object with an imageURL. |
| | | @param imageURL The URL to the photo |
| | | @param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the |
| | | application |
| | | @discussion This method should only be used when adding photo content to open graph stories. |
| | | |
| | | This method should only be used when adding photo content to open graph stories. |
| | | For example, if you're trying to share a photo from the web by itself, download the image and use |
| | | `photoWithImage:userGenerated:` instead. |
| | | */ |
| | | + (instancetype)photoWithImageURL:(NSURL *)imageURL userGenerated:(BOOL)userGenerated; |
| | | |
| | | /*! |
| | | @abstract If the photo is resident in memory, this method supplies the data. |
| | | /** |
| | | Convenience method to build a new photo object with a PHAsset. |
| | | - Parameter photoAsset: The PHAsset that represents the photo in the Photos library. |
| | | - Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the |
| | | application |
| | | */ |
| | | + (instancetype)photoWithPhotoAsset:(PHAsset *)photoAsset userGenerated:(BOOL)userGenerated; |
| | | |
| | | /** |
| | | If the photo is resident in memory, this method supplies the data. |
| | | @return UIImage representation of the photo |
| | | */ |
| | | @property (nonatomic, strong) UIImage *image; |
| | | @property (nonatomic, strong, nullable) UIImage *image; |
| | | |
| | | /*! |
| | | @abstract The URL to the photo. |
| | | /** |
| | | The URL to the photo. |
| | | @return URL that points to a network location or the location of the photo on disk |
| | | */ |
| | | @property (nonatomic, copy) NSURL *imageURL; |
| | | @property (nonatomic, copy, nullable) NSURL *imageURL; |
| | | |
| | | /*! |
| | | @abstract Specifies whether the photo represented by the receiver was generated by the user or by the application. |
| | | /** |
| | | The representation of the photo in the Photos library. |
| | | - Returns: PHAsset that represents the photo in the Photos library. |
| | | */ |
| | | @property (nonatomic, copy, nullable) PHAsset *photoAsset; |
| | | |
| | | /** |
| | | Specifies whether the photo represented by the receiver was generated by the user or by the application. |
| | | @return YES if the photo is user-generated, otherwise NO |
| | | */ |
| | | @property (nonatomic, assign, getter=isUserGenerated) BOOL userGenerated; |
| | | |
| | | /*! |
| | | @abstract Compares the receiver to another photo. |
| | | /** |
| | | The user generated caption for the photo. Note that the 'caption' must come from |
| | | * the user, as pre-filled content is forbidden by the Platform Policies (2.3). |
| | | @return the Photo's caption if exists else returns null. |
| | | */ |
| | | @property (nonatomic, copy, nullable) NSString *caption; |
| | | |
| | | /** |
| | | Compares the receiver to another photo. |
| | | @param photo The other photo |
| | | @return YES if the receiver's values are equal to the other photo's values; otherwise NO |
| | | */ |
| | | - (BOOL)isEqualToSharePhoto:(FBSDKSharePhoto *)photo; |
| | | |
| | | /*! |
| | | @abstract The user generated caption for the photo. Note that the 'caption' must come from |
| | | * the user, as pre-filled content is forbidden by the Platform Policies (2.3). |
| | | @return the Photo's caption if exists else returns null. |
| | | */ |
| | | @property (nonatomic, copy) NSString *caption; |
| | | |
| | | |
| | | @end |
| | | |
| | | NS_ASSUME_NONNULL_END |