//
|
// TWTRComposerViewController.h
|
// TwitterKit
|
//
|
// Copyright (c) 2015 Twitter. All rights reserved.
|
//
|
|
#import <UIKit/UIKit.h>
|
@class TWTRTweet;
|
@protocol TWTRComposerViewControllerDelegate;
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
/**
|
* Composer interface to allow users to compose & send Tweets from
|
* inside an app.
|
*
|
* It is the developers' responsibility to ensure that there exists a
|
* logged in Twitter user before creating a `TWTRComposerViewController`.
|
*
|
* See: https://dev.twitter.com/twitterkit/ios/compose-tweets#presenting-a-basic-composer
|
*
|
* Initial Text
|
* If you wish to add default mentions to the Tweet, add them to the
|
* beginning of `initialText`.
|
*
|
* If you wish to add default hashtags or links to the Tweet,
|
* add them at the end of `initialText`.
|
*/
|
@interface TWTRComposerViewController : UIViewController
|
|
/**
|
* The delegate for this composer view controller.
|
*/
|
@property (nonatomic, weak) id<TWTRComposerViewControllerDelegate> delegate;
|
|
/**
|
* Create an empty composer view controller. The developer must handle ensuring
|
* that a logged in Twitter user exists before creating this controller.
|
*/
|
+ (instancetype)emptyComposer;
|
|
/**
|
* Initialize a composer with pre-filled text and an image or video attachment.
|
* Requires a logged in Twitter user.
|
*
|
* @param initialText (optional) Text with which to pre-fill the composer text.
|
* @param image (optional) Image to add as an attachment.
|
* @param videoURL (optional) Video URL to add as an attachment. Of the form of `assets-library`.
|
*
|
* Note: Only one type of attachment (image or video) may be added.
|
*/
|
- (instancetype)initWithInitialText:(nullable NSString *)initialText image:(nullable UIImage *)image videoURL:(nullable NSURL *)videoURL;
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
@end
|
|
@protocol TWTRComposerViewControllerDelegate <NSObject>
|
|
@optional
|
/**
|
* Called when the user taps the cancel button. This method will be called after the view controller is dismissed.
|
*/
|
- (void)composerDidCancel:(TWTRComposerViewController *)controller;
|
|
/**
|
* Called when the user successfully sends a Tweet. The resulting Tweet object is returned.
|
* This method is called after the view controller is dimsissed and the API response is
|
* received.
|
*/
|
- (void)composerDidSucceed:(TWTRComposerViewController *)controller withTweet:(TWTRTweet *)tweet;
|
|
/**
|
* This method is called if the composer is not able to send the Tweet.
|
* The view controller will not be dismissed automatically if this method is called.
|
*/
|
- (void)composerDidFail:(TWTRComposerViewController *)controller withError:(NSError *)error;
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|
