HyphenateChatSDK  3.8.3.1
IEMChatManager.h
1 
15 #import <Foundation/Foundation.h>
16 
17 #import "EMCommonDefs.h"
18 #import "EMChatManagerDelegate.h"
19 #import "EMConversation.h"
20 
21 #import "EMMessage.h"
22 #import "EMTextMessageBody.h"
23 #import "EMLocationMessageBody.h"
24 #import "EMCmdMessageBody.h"
25 #import "EMFileMessageBody.h"
26 #import "EMImageMessageBody.h"
27 #import "EMVoiceMessageBody.h"
28 #import "EMVideoMessageBody.h"
29 #import "EMCustomMessageBody.h"
30 #import "EMCursorResult.h"
31 
32 #import "EMGroupMessageAck.h"
33 
34 @class EMError;
35 
45 @protocol IEMChatManager <NSObject>
46 
47 @required
48 
49 #pragma mark - Delegate
50 
64 - (void)addDelegate:(id<EMChatManagerDelegate>)aDelegate
65  delegateQueue:(dispatch_queue_t)aQueue;
66 
78 - (void)removeDelegate:(id<EMChatManagerDelegate>)aDelegate;
79 
80 #pragma mark - Conversation
81 
93 - (NSArray *)getAllConversations;
94 
103 - (void)getConversationsFromServer:(void (^)(NSArray *aCoversations, EMError *aError))aCompletionBlock;
104 
120 - (EMConversation *)getConversationWithConvId:(NSString *)aConversationId;
121 
141 - (EMConversation *)getConversation:(NSString *)aConversationId
142  type:(EMConversationType)aType
143  createIfNotExist:(BOOL)aIfCreate;
144 
161 - (void)deleteConversation:(NSString *)aConversationId
162  isDeleteMessages:(BOOL)aIsDeleteMessages
163  completion:(void (^)(NSString *aConversationId, EMError *aError))aCompletionBlock;
164 
181 - (void)deleteConversations:(NSArray *)aConversations
182  isDeleteMessages:(BOOL)aIsDeleteMessages
183  completion:(void (^)(EMError *aError))aCompletionBlock;
184 
200 - (void)importConversations:(NSArray *)aConversations
201  completion:(void (^)(EMError *aError))aCompletionBlock;
202 
203 #pragma mark - Message
204 
205 - (EMMessage *)getMessageWithMessageId:(NSString *)aMessageId;
206 
222 - (NSString *)getMessageAttachmentPath:(NSString *)aConversationId;
223 
238 - (void)importMessages:(NSArray *)aMessages
239  completion:(void (^)(EMError *aError))aCompletionBlock;
240 
255 - (void)updateMessage:(EMMessage *)aMessage
256  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock;
257 
276 - (void)sendMessageReadAck:(NSString *)aMessageId
277  toUser:(NSString *)aUsername
278  completion:(void (^)(EMError *aError))aCompletionBlock;
279 
280 
301 - (void)sendGroupMessageReadAck:(NSString *)aMessageId
302  toGroup:(NSString *)aGroupId
303  content:(NSString *)aContent
304  completion:(void (^)(EMError *aError))aCompletionBlock;
305 
322 - (void)ackConversationRead:(NSString *)conversationId
323  completion:(void (^)(EMError *aError))aCompletionBlock;
324 
342 - (void)recallMessageWithMessageId:(NSString *)aMessageId
343  completion:(void (^)(EMError *aError))aCompletionBlock;
344 
345 
361 - (void)sendMessage:(EMMessage *)aMessage
362  progress:(void (^)(int progress))aProgressBlock
363  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
364 
380 - (void)resendMessage:(EMMessage *)aMessage
381  progress:(void (^)(int progress))aProgressBlock
382  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
383 
400 - (void)downloadMessageThumbnail:(EMMessage *)aMessage
401  progress:(void (^)(int progress))aProgressBlock
402  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
403 
421 - (void)downloadMessageAttachment:(EMMessage *)aMessage
422  progress:(void (^)(int progress))aProgressBlock
423  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
424 
425 
426 
451 - (EMCursorResult *)fetchHistoryMessagesFromServer:(NSString *)aConversationId
452  conversationType:(EMConversationType)aConversationType
453  startMessageId:(NSString *)aStartMessageId
454  pageSize:(int)aPageSize
455  error:(EMError **)pError;
456 
457 
480 - (void)asyncFetchHistoryMessagesFromServer:(NSString *)aConversationId
481  conversationType:(EMConversationType)aConversationType
482  startMessageId:(NSString *)aStartMessageId
483  pageSize:(int)aPageSize
484  completion:(void (^)(EMCursorResult *aResult, EMError *aError))aCompletionBlock;
485 
486 
509 - (void)asyncFetchGroupMessageAcksFromServer:(NSString *)aMessageId
510  groupId:(NSString *)aGroupId
511  startGroupAckId:(NSString *)aGroupAckId
512  pageSize:(int)aPageSize
513  completion:(void (^)(EMCursorResult *aResult, EMError *error, int totalCount))aCompletionBlock;
514 
515 #pragma mark - EM_DEPRECATED_IOS 3.6.1
516 
533 - (void)sendMessageReadAck:(EMMessage *)aMessage
534  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock EM_DEPRECATED_IOS(3_3_0, 3_6_1, "Use -[IEMChatManager sendMessageReadAck:toUser:completion:]");
535 
536 
554 - (void)recallMessage:(EMMessage *)aMessage
555  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock EM_DEPRECATED_IOS(3_3_0, 3_6_1, "Use -[IEMChatManager recallMessageWithMessageId:completion:]");
556 
557 
558 #pragma mark - EM_DEPRECATED_IOS 3.2.3
559 
571 - (void)addDelegate:(id<EMChatManagerDelegate>)aDelegate EM_DEPRECATED_IOS(3_1_0, 3_2_2, "Use -[IEMChatManager addDelegate:delegateQueue:]");
572 
573 #pragma mark - EM_DEPRECATED_IOS < 3.2.3
574 
590 - (NSArray *)loadAllConversationsFromDB __deprecated_msg("Use -getAllConversations");
591 
609 - (BOOL)deleteConversation:(NSString *)aConversationId
610  deleteMessages:(BOOL)aDeleteMessage __deprecated_msg("Use -deleteConversation:isDeleteMessages:completion:");
611 
629 - (BOOL)deleteConversations:(NSArray *)aConversations
630  deleteMessages:(BOOL)aDeleteMessage __deprecated_msg("Use -deleteConversations:isDeleteMessages:completion:");
631 
647 - (BOOL)importConversations:(NSArray *)aConversations __deprecated_msg("Use -importConversations:completion:");
648 
664 - (BOOL)importMessages:(NSArray *)aMessages __deprecated_msg("Use -importMessages:completion:");
665 
681 - (BOOL)updateMessage:(EMMessage *)aMessage __deprecated_msg("Use -updateMessage:completion:");
682 
698 - (void)asyncSendReadAckForMessage:(EMMessage *)aMessage __deprecated_msg("Use -sendMessageReadAck:completion:");
699 
720 - (void)asyncSendMessage:(EMMessage *)aMessage
721  progress:(void (^)(int progress))aProgressCompletion
722  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -sendMessage:progress:completion:");
723 
743 - (void)asyncResendMessage:(EMMessage *)aMessage
744  progress:(void (^)(int progress))aProgressCompletion
745  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -resendMessage:progress:completion:");
746 
766 - (void)asyncDownloadMessageThumbnail:(EMMessage *)aMessage
767  progress:(void (^)(int progress))aProgressCompletion
768  completion:(void (^)(EMMessage * message, EMError *error))aCompletion __deprecated_msg("Use -downloadMessageThumbnail:progress:completion:");
769 
789 - (void)asyncDownloadMessageAttachments:(EMMessage *)aMessage
790  progress:(void (^)(int progress))aProgressCompletion
791  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -downloadMessageAttachment:progress:completion");
816 - (void)loadMessagesWithType:(EMMessageBodyType)aType
817  timestamp:(long long)aTimestamp
818  count:(int)aCount
819  fromUser:(NSString*)aUsername
820  searchDirection:(EMMessageSearchDirection)aDirection
821  completion:(void (^)(NSArray *aMessages, EMError *aError))aCompletionBlock;
822 
847 - (void)loadMessagesWithKeyword:(NSString*)aKeywords
848  timestamp:(long long)aTimestamp
849  count:(int)aCount
850  fromUser:(NSString*)aSender
851  searchDirection:(EMMessageSearchDirection)aDirection
852  completion:(void (^)(NSArray *aMessages, EMError *aError))aCompletionBlock;
853 
854 @end
Definition: EMConversation.h:55
Definition: EMCursorResult.h:25
Definition: EMError.h:27
Definition: EMMessage.h:66
Definition: EMChatManagerDelegate.h:27
Definition: IEMChatManager.h:45
NSArray * getAllConversations()
"Use -getAllConversations" __deprecated_msg()