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.
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
categories
NSMutableArray
The categories that should be displayed to the user while creating a new conversation
avatar
UIImage
The avatar that will be displayed next to every conversation
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
- (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.
Styling
ICInboxTableView
This component displays a list of a conversations that are provided via the dataSource
This component displays a list of a conversations that are provided via the dataSource
Properties
inboxDataSource
id<ICInboxTableViewDataSource>
See ICInboxTableViewDataSource description
inboxDelegate
id<ICInboxTableViewDelegate>
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<ICMessagePartViewFactory>)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<ICMessageData>)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<ICMessageData>)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<ICMessageData>)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<ICMessageData>)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<ICMessageData>)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
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.
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 ICMessaging messageStore.
Properties:
thread
ICThread
See CoreSDK reference guide
flavor
ICMessageComposerFlavor
See the ICMessageComposerFlavor description.
delegate
id<ICConversationViewControllerDelegate>
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<ICConversationCollectionViewDataSource>
See ICConversationCollectionViewDataSource description
conversationDelegate
id<ICConversationCollectionViewDelegate>
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<ICMessagePartViewFactory>)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<ICMessageData>)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<ICMessageData>)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<ICMessageData>)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<ICMessageData>)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<ICMessagePart>)messagePart
Tells the delegate that a message part has been deleted
- (void)conversationCollectionView:(ICConversationCollectionView *)conversationCollectionView
didSelectRetryForMessageData:(id<ICMessageData>)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:
-(NSString )reuseIdentifierForMessageData:(id<ICMessageData>)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.
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<ICConversationCategoryViewControllerDelegate>
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:
-(void)conversationCategoryViewController:
(ICConversationCategoryViewController )conversationCategoryViewController didSelectConversationCategory:(ICConversationCategory )conversationCategory parentCategory:(ICConversationCategory *)parentCategory
Invoked when a final category selection is made.
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:
-(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
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
NSString
The customer's email
phoneNumber
NSString
The customer's phone number
Methods:
-(instancetype)initWithDictionary:(NSDictionary *)dictionary
Instantiates an ICCustomerDetails with a dictionary
-(NSDictionary *)dictionary
Retrieves a dictionary from the customer details object
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:
-(NSDictionary *)dictionary
Parses the ICConversationDetails to a dictionary.
-(void)enrich:(ICMessage *)message
Enriches a message instance with the customer details.
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:
-(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<ICMessageData>)messageData withMessageParts:(NSArray *)messageParts
Associates a message and its message parts with the container view.
This is an abstract that represents a message part. This class can represent a text or an attachment for example.
Properties:
delegate
id<ICMessagePartViewDelegate>
See ICMessagePartViewDelegate description
messagePart
id<ICMessagePart>
The message part associated to the view
messageData
Id<ICMessageData>
The message data associated to the view
Methods:
-(void)setMessagePart:(id<ICMessagePart>)messagePart withMessageData:(id<ICMessageData>)messageData
Associates a message and its message part with the part view
-(CGSize)messagePartView:(I*CMessagePartView )messagePartView sizeForMessagePart:(id<ICMessagePart>)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<ICMessagePart>)messagePart
Informs when a message part has been removed.
-(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<ICMediaPartViewDelegate>
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
durationTextColor
UIColor
The duration text color
durationFont
UIFont
The duration font
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
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
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
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<ICMessageComposerViewDelegate>
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:
- (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:
- (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<ICMessageComposerTextViewDelegate>
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:
- (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:
- (void)addMessagePart:(id<ICMessagePart>)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<ICMessagePart>)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<ICMessageComposerAudioPluginViewControllerDelegate>
See the ICMessageComposerAudioPluginViewControllerDelegate description
ICMessageComposerAudioPluginViewController
Methods:
- (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<ICMessageComposerLocationPluginViewControllerDelegate>
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:
- (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