API Reference

The IMIconnect UI SDK for iOS builds on the message transport capabilities exposed within the Core SDK through a collection of customisable user interface components. These components may be used to easily integrate a fully featured rich messaging capability within the host application.

The information below serves as a reference and details all of the public classes, interfaces, and methods. A quick start guide is also available.

ICConversationSplitViewController

This view controller leverages the functionality of the lower level components and provides the necessary wiring to combine them into a fully-featured in-app chat experience with minimal code.
The activity supports the display of the user conversation list and provides a means to open them or create new conversations. Selecting a conversation displays the conversation view and allows users to read, compose and send messages.

Prerequisites

This component requires that a valid ICMessageStore instance is set within the Core SDK.

Adaptive Layout

The layout of the view controller adapts to the device display, typically when running on a iPhone the activity will display the conversation list full screen when a conversation is displayed this replaces the conversation list display. Navigating back from the conversation will cause the conversation list to be re-displayed.
When running on an iPad, the layout is split into two sections. The conversation list is shown on the left and the active conversation is shown on the right.

Properties

Parameter	Type	Description
categories	NSMutableArray	The categories that should be displayed to the user while creating a new conversation
customerDetails	ICCustomerDetails	Refer - ICCustomerDetails class
avatar	UIImage	The avatar that will be displayed next to every conversation

ICConversationsViewController

Displays a list of conversations for the current user and a floating action button for creating a new conversation; use this view controller when you wish to integrate a conversation list within your own layouts.

The view controller does not open or create new conversations directly; instead, events are raised through the ICConversationsViewControllerDelegate and it is your responsibility to write the code in response to those events if you are not using ICConversationSplitViewController.

Message data is lazily loaded from a local ICMessageStore and remotely from the IMIconnect backend services. To achieve the best possible user experience, it is recommended that you configure an appropriate message synchronisation policy within the Core SDK in order to pre-fetch data.

Prerequisites

This component loads data from ICMessageStore and therefore requires that a valid instance is set within the Core SDK, please refer to ICMessagingStore.

If you are not using ICConversationSplitViewController, you must implement the ICConversationsViewControllerDelegate.

Properties


delegate	ICConversationsViewControllerDelegate	The delegate of the ICConversationsViewController
avatar	UIImage	The avatar that will be displayed next to each conversation

Methods


(void)reload	Reloads the whole conversation list

Responding to events

Whenever a user selects a conversation or taps the create conversation button, the appropriate event will be raised through the ICConversationsViewControllerDelegate interface.

ICConversationsViewControllerDelegate

Methods:


(void)conversationsViewController: (ICConversationsViewController )conversationsViewController didSelectThread:(ICThread )thread	Invoked when a user selects a conversation within the view controller. Conversations are represented by an ICThread object, please refer to the Core SDK documentation for details. Typically, you will use the id within ICThread to open the conversation.
(void)conversationsViewControllerDidSelectCreateThread: (ICConversationsViewController *)conversationsViewController	Invoked when a user taps the create conversation button. You are responsible for creating the new thread and displaying the conversation UI to the user. If you have multiple contact points you may wish to consider using ICConversationCategoryViewController as an easy way to present these.Use the ICMessaging createThread method within the Core SDK to create a new thread, please refer to the Core SDK documentation for more information.

(void)conversationsViewController: (ICConversationsViewController )conversationsViewController didSelectThread:(ICThread )thread

Invoked when a user selects a conversation within the view controller. Conversations are represented by an ICThread object, please refer to the Core SDK documentation for details. Typically, you will use the id within ICThread to open the conversation.

(void)conversationsViewControllerDidSelectCreateThread: (ICConversationsViewController *)conversationsViewController

Invoked when a user taps the create conversation button. You are responsible for creating the new thread and displaying the conversation UI to the user. If you have multiple contact points you may wish to consider using ICConversationCategoryViewController as an easy way to present these.Use the ICMessaging createThread method within the Core SDK to create a new thread, please refer to the Core SDK documentation for more information.

Styling

ICInboxTableView

This component displays a list of a conversations that are provided via the dataSource

Properties


inboxDataSource	id	See ICInboxTableViewDataSource description
inboxDelegate	id	See ICInboxTableViewDelegate
cellFactory	ICMessageTableViewCellFactory	See ICMessageTableViewCellFactory description
selectedIndexes	NSMutableArray	The selected indexes
backgroundColor	UIColor	The table view background color

Methods:


(void)reloadMessages	Reloads the inbox display.
(void)addMessagePartViewFactory:(id)messagePartViewFactory forContentType:(NSString *)contentType	Adds a messagePartViewFactory instance in the list of all messagePartViewFactories to create the MessagePartView The content type is used to retrieve the good factory based on the content type of the encountered message part.
(void)enableMultipleSelection:(BOOL)isEnabled	Enables the multiple row selection
(void)scrollToMessage:(id)messageData animated:(BOOL)animated	Scrolls to a message in the inbox

ICInboxTableViewDataSource

Contains the methods needed to populate the ICInboxTableView with some data

Methods:


(NSInteger)numberOfMessagesInInboxTableView:(ICInboxTableView *)inboxTableView	Tells the data source to return the number of messages that will be displayed in the inbox table view
(id)inboxTableView:(ICInboxTableView )inboxTableView messageDataForRowAtIndexPath:(NSIndexPath )indexPath	Asks the data source the message data that will be represented by the cell
(NSArray )inboxTableView:(ICInboxTableView )inboxTableView messagePartsFromMessageData:(id)messageDat	Asks the data source the message part that will be displayed for a message data
(NSInteger)inboxTableView:(ICInboxTableView )inboxTableView numberOfUnreadMessagesAtIndexPath:(NSIndexPath )indexPath	Tells the data source to return the number of unread messages for the cell
(BOOL)inboxTableView:(ICInboxTableView )inboxTableView shouldDisplayUnreadIndicatorAtIndexPath:(NSIndexPath )indexPath	Tells the data source to display the unread indicator
(UIImage )inboxTableView:(ICInboxTableView )inboxTableView avatarForMessageData:(id)messageData	Asks the data source to provide the avatar a specified message

ICInboxTableViewDelegate

Contains the methods needed to handle an event on the ICInboxTableView.

Methods:


(CGFloat)inboxTableView:(ICInboxTableView )inboxTableView heightForMessageCellAtIndexPath:(NSIndexPath )indexPath	Asks the data source for the height to use for a message cell in a specified location.
(void)inboxTableView:(ICInboxTableView )inboxTableView didSelectMessageDataAtIndexPath:(NSIndexPath )indexPath	Tells the delegate that a message has been selected
(void)inboxTableView:(ICInboxTableView )inboxTableView didDeleteMessageDataAtIndexPath:(NSIndexPath )indexPath	Tells the delegate that a message has been deleted

ICInboxMessageTableViewCell

This component is a concrete implementation of the ICMessageTableViewCell.

Properties:


dateFont	UIFont	The font of the date label
dateTextColor	UIColor	The text color of the date label
badgeFont	UIFont	The font of the badge label
badgeTextColor	UIColor	The text color of the badge
badgeBackgroundColor	UIColor	The background color of the badge
badgeCornerRadius	CGFloat	The corner radius of the badge
unreadMessageFont	UIFont	The unread message font
unreadMessageTextColor	UIColor	The unread message text color
unreadDateFont	UIFont	The unread date font
unreadDateTextColor	UIColor	The unread date text color
readMessageFont	UIFont	The read message font
readMessageTextColor	UIColor	The read message text color
titleFont	UIFont	The read message font
titleTextColor	UIColor	The read message text color
containerTextColor	UIColor	The container text color

ICMessageTableViewCellFactory

This factory has the responsibility to create all the table view cells that will be displayed in the inbox.


-(NSString )reuseIdentifierForMessageData:(id)messageData fromMessageParts:(NSArray )messageParts :(NSDictionary *)messagePartViewFactories	Retrieves an identifier used to reuse an existing cell
-(ICMessageTableViewCell )cellForIdentifier:(NSString )identifier fromMessageParts:(NSArray )messageParts withMessagePartViewFactories:(NSDictionary )messagePartViewFactories	Creates a cell that will represent the message parts passed in parameter

ICConversationViewController

The ICConversationViewController displays messages within a conversation and provides a message composer.

Messages are displayed to the user in chronological order and new messages can be composed and published directly from the view controller. Supports typing indicators, delivery and read receipts, message attachments and connection indicator.

Prerequisites

This component loads data from ICMessageStore and therefore requires that a valid instance is set within the Core SDK, please refer to ICMessaging messageStore.

Properties:


thread	ICThread	See CoreSDK reference guide
flavor	ICMessageComposerFlavor	See the ICMessageComposerFlavor description.
delegate	id	See ICConversationViewControllerDelegate description

Methods:


-(void)reloadMessages	Reload all the messages of the current conversation

Styling

ICMessageComposerFlavor

This class allows you to customise the composer. You can select the plugins that will be displayed in the composer and the composer style.

Properties:


plugins	NSArray	An array of plugins that will be displayed in the composer.
style	ICMessageComposerStyle	See ICMessageComposerStyle description

Methods:


(instancetype)flavorWithStyle:(ICMessageComposerStyle )style plugins:(NSArray )plugins;	Instantiates an ICMessageComposerFlavor with a style and some plugins

ICMessageComposerStyle

Determines the style (color and appearances) of the message composer.

Properties:


composerBackgroundColor	UIColor	The composer background color
borderWidth	CGFloat	The border width
borderColor	UIColor	The border color
cornerRadius	CGFloat	The corner radius
backgroundColor	UIColor	The background color
messageTextColor	UIColor	The message text color
messageFont	UIFont	The message font

ICConversationCollectionView

This component will display the incoming and outgoing messages in some bubbles.

Properties


conversationDataSource	id	See ICConversationCollectionViewDataSource description
conversationDelegate	id	See ICConversationCollectionViewDelegate description
cellFactory	ICMessageCollectionViewCellFactory	See ICMessageCollectionViewCellFactory description
isScrollingTop	BOOL	Informs if the user is currently scrolling to top
backgroundColor	UIColor	The background color

Methods:


(void)reloadMessages	Reloads the conversation display.
(void)addMessagePartViewFactory:(id)messagePartViewFactory forContentType:(NSString *)contentType	Adds a messagePartViewFactory instance in the list of all messagePartViewFactories to create the MessagePartView The content type is used to retrieve the good factory
(void)scrollToBottomAnimated:(BOOL)animated	Scrolls the conversation collection view to the bottom
(void)scrollToMessage:(id)messageData animated:(BOOL)animated	Scrolls to a message in the conversation

ICConversationCollectionViewDataSource

Contains the methods needed to populate the ICConversationCollectionView with some data

Methods:


(NSInteger)conversationCollectionView:(ICConversationCollectionView )conversationCollectionView numberOfMessagesForMessageGroup:(NSString )messageGroup	Tells the data source to return the number of messages that will be displayed in the conversation collection view
(id)conversationCollectionView:(ICConversationCollectionView )conversationCollectionView messageDataForItemAtIndex:(NSInteger)index forMessageGroup:(NSString )messageGroup	Asks the data source the message data that will be represented by the cell
(NSArray )conversationCollectionView:(ICConversationCollectionView )conversationCollectionView messagePartsFromMessageData:(id)messageData	Asks the data source the message part that will be displayed for a message data
(NSInteger)numberOfMessageGroupsInConversationCollectionView:(ICConversationCollectionView *)conversationCollectionView	Tells the data source to return the number of groups that will be displayed in the conversation collection view
(NSString )conversationCollectionView:(ICConversationCollectionView )conversationCollectionView messageGroupAtIndex:(NSInteger)index	Asks the data source the message group that will be displayed at an index
(BOOL)conversationCollectionView:(ICConversationCollectionView *)conversationCollectionView shouldDisplayStatusForMessageData:(id)messageData	Asks the data source to return the bool value of messages that will be displayed in the conversation collection view

ICConversationCollectionViewDelegate

Contains the methods needed to handle an event on the ICConversationCollectionView.

Methods:


(CGFloat)conversationCollectionView:(ICConversationCollectionView )conversationCollectionView heightForMessageCellAtIndexPath:(NSIndexPath )indexPath	Asks the delegate for the height to use for a message cell in a specified location.
(CGFloat)conversationCollectionView:(ICConversationCollectionView *)conversationCollectionView heightForMessageGroupAtIndex:(NSInteger)index	Asks the delegate for the height to use for a message group in a specified location.
(void)conversationCollectionView:(ICConversationCollectionView )conversationCollectionView didSelectAttachmentMessagePart:(ICMediaMessagePart )mediaMessagePart	Tells the delegate that an attachment has been selected
(void)conversationCollectionView:(ICConversationCollectionView *)conversationCollectionView didRemoveMessagePart:(id)messagePart	Tells the delegate that a message part has been deleted
(void)conversationCollectionView:(ICConversationCollectionView *)conversationCollectionView didSelectRetryForMessageData:(id)messageData	Tells the delegate that the user is trying to re-send a message

ICAlertMessageCollectionViewCell

Displays an alert event in the ICConversationCollection. This alert could be a conversation that is now closed or reopened for example.

Properties:


containerBackgroundColor	UIColor	The container background color.
containerCornerRadius	CGFloat	The corner radius of the bubble.
containerTextColor	UIColor	The text color of the container.
containerFont	UIFont	The font of the container.

ICIncomingMessageCollectionViewCell

Displays the incoming messages in the ICConversationCollection. It has the appearance of a bubble.

Properties:


containerBackgroundColor	UIColor	The container background color.
containerCornerRadius	CGFloat	The corner radius of the bubble.
containerTextColor	UIColor	The text color of the container.
containerFont	UIFont	The font of the container.

ICOutgoingMessageCollectionViewCell

Displays the outgoing messages in the ICConversationCollection. It has the appearance of a bubble.

Properties:


containerBackgroundColor	UIColor	The container background color.
containerCornerRadius	CGFloat	The corner radius of the bubble.
containerTextColor	UIColor	The text color of the container.
containerFont	UIFont	The font of the container.
messageStateFont	UIFont	The message state font.
timeFont	UIFont	The font of the time.

Methods:


-(void)showFooter	Shows the footer of the cell.
-(void)hideFooter	Hides the footer of the cell.

ICConversationHeaderCollectionReusableView

Displays the group where the messages belong. Those groups represents by default the day when the messages have been received.

Properties


messageGroupFont	UIFont	The message group font.
messageGroupTextColor	UIColor	The message group text color.

ICMessageCollectionViewCellFactory

This factory has the responsibility to create all the collection view cells that will be displayed in the conversation.

Methods:

Syntax	Description
-(NSString )reuseIdentifierForMessageData:(id)messageDatafromMessageParts:(NSArray )messagePartswithMessagePartViewFactories:(NSDictionary *)messagePartViewFactories	Retrieves an identifier used to reuse an existing cell.
-(UINib )nibForIdentifier:(NSString )identifier fromMessageParts:(NSArray )messageParts withMessagePartViewFactories:(NSDictionary )messagePartViewFactories	Retrieves the nib associated to the current identifier in order to be registered to be used in the conversation cell.
-(Class)classForIdentifier:(NSString )identifier fromMessageParts:(NSArray )messageParts withMessagePartViewFactories:(NSDictionary *)messagePartViewFactories	Retrieves the class associated to the current identifier in order to be registered to be used in the conversation cell.

ICConversationCategoryViewController

The ICConversationCategoryViewController displays a list of conversation categories.

Categories are represented by ICConversationCategory instances, these instances may be nested to create a hierarchy of categories. The view controller displays one level of categories at a time when the user taps a category the fragment with either:

(a) Where the category has sub-categories, displays the list of sub-categories
(b) Where the category does not have sub-categories, raise an event via the

Properties:


categories	NSMutableArray	The categories that isdisplayed to the user while creating a new conversation
delegate	id	The ICConversationCateogryViewController delegate

Interaction

The view controller displays a single level of categories at a time, if a category is selected which has sub-categories then the sub-category list replaces that which is currently shown. Pressing the back button will navigate up one level in the hierarchy.

When a final selection is made the selection is raised as an event through the ICConversationCategoryViewControllerDelegate. A final selection is determined as a category that has no sub-categories.

ICConversationCategoryViewControllerDelegate

Methods:

Syntax	Description
-(void)conversationCategoryViewController: (ICConversationCategoryViewController )conversationCategoryViewController didSelectConversationCategory:(ICConversationCategory )conversationCategory parentCategory:(ICConversationCategory *)parentCategory	Invoked when a final category selection is made.

ICConversationCategory

Organisations typically have multiple contact points to which a customer may be directed depending on their query. Conversation categories provide the means to drive users to the correct contact point.

The information contained in a ICConversationCategory instance is also used to establish the correct communication stream for a conversation. Within IMIconnect, real-time messages are sent over a stream, the stream is used to direct messages to the correct service to process the message.

Properties:


title	NSString	The title of the category.
streamName	NSString	The stream name of the category.
image	UIImage	The image of the category.
subCategories	NSMutableArray	the sub categories.

Methods:

Syntax	Description
-(instancetype)initWithTitle:(NSString )title streamName:(NSString )streamName	Instantiates an ICConversationCategory instance with a title and a streamName
-(instancetype)initWithTitle:(NSString )title streamName:(NSString )streamName image:(UIImage *)image	Instantiates an ICConversationCategory instance with a title, a streamName and an image
-(instancetype)initWithTitle:(NSString )title streamName:(NSString )streamName image:(UIImage )image subCategories:(NSMutableArray )subCategories	Instantiates an ICConversationCategory instance with a title, a streamName, an image and subcategories

ICCustomerDetails

Certain integrations, such as IMIchat, allow customer details to be sent to the agent serving customer requests. This class encapsulates that information.

Properties:


firstName	NSString	The customer's first name
lastName	NSString	The customer's last name
email	NSString	The customer's email
phoneNumber	NSString	The customer's phone number

Methods:

Syntax	Description
-(instancetype)initWithDictionary:(NSDictionary *)dictionary	Instantiates an ICCustomerDetails with a dictionary
-(NSDictionary *)dictionary	Retrieves a dictionary from the customer details object

ICConversationDetails

The ICConversationDetails Contains data relating to a conversation.

Certain integrations, such as IMIchat, require certain information about a conversation to be transmitted to the customer service agent. This class holds this data.

Properties:


thread	ICThread	The conversation’s thread
customerDetails	ICCustomerDetails	The conversation’s customer details
category	NSString	The conversation’s category
subCategory	NSString	The conversation’s subcategory

Methods:

Syntax	Description
-(NSDictionary *)dictionary	Parses the ICConversationDetails to a dictionary.
-(void)enrich:(ICMessage *)message	Enriches a message instance with the customer details.

ICMessagePartContainerView

The ICMessagePartContainerView Contains all the part views that represent the content of an ICMessageData instance.

Properties:


messagePartViews	NSMutableArray	The array of all the part views that are contained by the container view.

Methods:

Syntax	Description
-(void)addPartView:(ICMessagePartView *)partView	Adds a part view to the container view
-(void)resizeConstraints:(CGSize)size	Resizes the container’s layout constraints
-(void)setMessageData:(id)messageData withMessageParts:(NSArray *)messageParts	Associates a message and its message parts with the container view.

ICMessagePartView

This is an abstract that represents a message part. This class can represent a text or an attachment for example.

Properties:


delegate	id	See ICMessagePartViewDelegate description
messagePart	id	The message part associated to the view
messageData	Id	The message data associated to the view

Methods:

Syntax	Description
-(void)setMessagePart:(id)messagePart withMessageData:(id)messageData	Associates a message and its message part with the part view

ICMessagePartViewDelegate

Methods:

Syntax	Description
-(CGSize)messagePartView:(I*CMessagePartView )messagePartView sizeForMessagePart:(id)messagePart	Provides the size for a message part.
-(void)messagePartView:(ICMessagePartView *)messagePartView didUpdateHeight:(CGFloat)height	Informs when the height has changed.
-(void)messagePartView:(ICMessagePartView *)messagePartView didRemoveMessagePart:(id)messagePart	Informs when a message part has been removed.

ICMessagePartViewDataSource

Methods:


-(void)resizeInContainerSize:(CGSize)containerSize	Resizes the message part view

ICMessagePartViewFactory

This interface represents all the methods needed to create the part views that will be displayed in either an inbox cell or a conversation cell


-(NSString *)contentType	Indicates the type of the message part handled by the factory.
-(ICMessagePartView *)createMessagePartView	Creates a new ICMessagePartView depending on the content type of the message part.

ICAudioPartViewFactory

This class implements the ICMessagePartViewFactory and is responsible for the create of the ICAudioPartView

ICFilePartViewFactory

This class implements the ICMessagePartViewFactory and is responsible for the create of the ICFilePartView

ICImagePartViewFactory

This class implements the ICMessagePartViewFactory and is responsible for the create of the ICImagePartView

ICVideoPartViewFactory

This class implements the ICMessagePartViewFactory and is responsible for the create of the ICVideoPartView

ICTextPartView

This component displays a text from a message

Properties:


textColor	UIColor	The text part view’s text color
font	UIFont	The text part view’s font

ICURLPartView

This component displays a URL preview from a message

ICMediaPartView

This component displays an attachment from a message.

Properties:


mediaDelegate	id	See ICMediaPartViewDelegate description
mediaTapGestureRecognizer	UITapGestureRecognizer	The tap gesture recognizer that will be trigger when a user clicks on a media part view

Methods:


(void)displayDownloadView:(BOOL)shouldDisplayView	Displays/Hides the download view
(void)startDownload	Starts downloading a file attached to a media
(void)downloadWillStart	Tells the subclass that the download will start
(void)downloadDidEnd	Tells the subclass that the download will start
(void)showProcessIndicator:(BOOL)isProcessing	Shows/Hides the process indicator

ICAudioPartView

This component displays an audio attachment from a message.

Properties


durationTextColor	UIColor	The duration text color
durationFont	UIFont	The duration font

ICFilePartView

This component displays a file attachment from a message.

Properties:


fileTextColor	UIColor	The file text color
fileFont	UIFont	The file font

ICImagePartView

This component displays an image attachment from a message.

ICLocationPartView

This component displays a location attachment from a message.

ICVideoPartView

This component displays a video attachment from a message.

Properties:


durationTextColor	UIColor	The duration text color
durationFont	UIFont	The duration font
stateBackgroundColor	UIColor	The state background color

ICConnectionStatusView

The view is displayed to show the current connection status with the message broker.
3 statuses can be displayed: “Connected.”, “Connecting…” and “Disconnected.”

Properties:


disconnectedBackgroundColor	UIColor	The disconnected background color
disconnectedTextColor	UIColor	The disconnected text color
connectingBackgroundColor	UIColor	The connecting background color
connectingTextColor	UIColor	The connecting text color
connectedBackgroundColor	UIColor	The connected background color
connectedTextColor	UIColor	The connected text color
connectionStatus	ICConnectionStatus	The current connection status

ICConversationButton

This button allows the user to open a new conversation screen. Some features will be added to that component in the future.

Properties:


buttonBackgroundColor	UIColor	The conversation’s button background color
buttonTintColor	UIColor	The conversation’s tint background color
buttonTextColor	UIColor	The conversation’s text background color
buttonCornerRadius	CGFloat	The conversation’s corner radius

ICMessagePart

This interface represents a part of the message that the developer wants to display in a partial view.

Properties:


contentType	NSString	The message part content type

ICTextMessagePart

This class will retrieve all the text that will be displayed for a specific message.

Properties:


text	NSString	The message text

ICAttachmentMessagePart

This class will retrieve a single attachment that will be displayed for a specific message.

Properties:


filePath	NSURL	The file path where the message is locally stored
attachment	ICAttachment	The attachment that should be displayed in the message part view

ICURLMessagePart

This class will retrieve a URL from which a preview will be displayed for a specific message

Properties:


url	NSURL	The URL that will be represented in the message part view

ICMessageComposerView

This view represents the composer to write down some messages and add some
attachments to these messages. To add some attachments to the message some
plugins must be registered. These plugins will allow the user to pick some
photos/videos, share a location or record some audio message for example.

Properties:


delegate	id	See ICMessageComposerViewDelegate description
composerTextView	ICMessageComposerTextView	See ICMessageComposerTextView description
borderWidth	CGFloat	The border width
borderColor	UIColor	The border color
cornerRadius	CGFloat	The corner radius
backgroundColor	UIColor	The background color
composerBackgroundColor	UIColor	The composer background color

Methods:

Syntax	Description
(void)registerPlugins:(NSArray *)plugins	Registers an array of plugins
(void)registerPlugin:(ICMessageComposerPlugin *)plugin	Registers a plugin

ICMessageComposerViewDelegate

This interface will warn the delegate each time an action has been made on the
composer.

Methods:

Syntax	Description
(void)didComposeMessage:(ICMessage )message withMessageParts:(NSArray )messageParts	Tells the delegate that a message has been composed and provides the eventual message parts attached to that message
(void)presentPluginOptionsInAlertController:(UIAlertController *)alertController	Tells the delegate to present an alertController containing plugin options
(void)didSelectPlugin:(ICMessageComposerPlugin *)plugin	Tells the delegate that a plugin has been selected by the user
(void)messageComposerView:(ICMessageComposerView *)messageComposerView didUpdateHeight:(CGFloat)height	Tells the delegate that the message composer view has updated its height
(void)messageComposerViewDidStartTyping:(ICMessageComposerView *)messageComposerView	Tells the delegate that the user is typing
(void)messageComposerViewDidStopTyping:(ICMessageComposerView *)messageComposerView	Tells the delegate that the user is not typing anymore

ICMessageComposerTextView

This class represents the part of the composer when the user types some text.

Properties:


composerTextDelegate	id	See ICMessageComposerTextViewDelegate description
messageTextColor	UIColor	The message text color
messageFont	UIFont	The message text font size
placeHolderText	NSString	The place holder text
placeHolderTextColor	UIColor	The place holder text color

Methods:

Syntax	Description
(void)clear	Clears the composer text view and show the place holder

ICMessageComposerPlugin

This abstract class represents a way to add an attachment to a message. It can
be a photo picker, an audio recorder etc,

Properties:


title	NSString	The plugin title

Methods:

Syntax	Description
(void)addMessagePart:(id)messagePart withThumbnail:(UIImage *)thumbnail	This method should be called when a message part has been selected and his associated thumbnail generated
(instancetype)pluginWithTitle:(NSString *)title	Instantiates a plugin
(void)presentFromViewController:(UIViewController *)viewController	Shows the graphic component associated to the plugin from a view controller
(void)addMessagePart:(id)messagePart toMessage:(ICMessage *)message	Associates a message part to a message when the user has clicked on the Send button

ICMessageComposerAudioPlugin

This class represents a way to transform a recorded audio to an audio attachment

ICMessageComposerAudioPluginViewController

This class provides an easy way to record an audio

Properties:


delegate	Id	See the ICMessageComposerAudioPluginViewControllerDelegate description

ICMessageComposerAudioPluginViewController

Methods:

Syntax	Description
(void)audioPluginViewController:(ICMessageComposerAudioPluginViewController )audioPluginViewController didFinishRecordingAudioAtURL:(NSURL )url withDuration:(CGFloat)duration	Tells the delegate that the audio has finished being recorded

ICMessageComposerLocationPlugin

This class represents a way to transform a selected location to a location
attachment

ICMessageComposerLocationPluginViewController

This class provides an easy way to pick a location

Properties:


delegate	Id	See the ICMessageComposerLocationPluginViewControllerDelegate description

ICMessageComposerLocationPluginViewControllerDelegate

Methods:


(void)locationPluginViewController:(ICMessageComposerLocationPluginViewController )locationPluginViewController didFinishPickingLocation:(CLLocation )location :(NSString *)address inRegion:(MKCoordinateRegion)region	Tells the delegate that the user has picked a location

ICMessageComposerFilePlugin

This class represents a way to transform a selected file to a file attachment

ICMessageComposerImagePlugin

This class represents a way to transform a selected image to an image attachment

Properties:


sourceType	UIImagePickerControllerSourceType	The source type of the image. It can be the library or directly the camera

ICImageViewController

This class provides a way to show an image in full screen

Properties:


Image	UIImage	The image that will be displayed in full screen

ICFileViewController

This class displays a preview of a file

Methods:

Syntax	Description
(void)showFilePreview:(NSURL *)filePath	Shows a file preview from a file path

ICMediaHandler

Handles an interaction with a media with a default behaviour

Methods:


(instancetype)shared	Gives a single instance of an ICMediaHandler
(void)handleMediaMessagePart:(ICMediaMessagePart )mediaMessagePart fromViewController:(UIViewController )viewController	Handles a media message part with a default behaviour