HyphenateSDK 3.6.3
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 "EMCursorResult.h"
30 
31 #import "EMGroupMessageAck.h"
32 
33 @class EMError;
34 
44 @protocol IEMChatManager <NSObject>
45 
46 @required
47 
48 #pragma mark - Delegate
49 
63 - (void)addDelegate:(id<EMChatManagerDelegate>)aDelegate
64  delegateQueue:(dispatch_queue_t)aQueue;
65 
77 - (void)removeDelegate:(id<EMChatManagerDelegate>)aDelegate;
78 
79 #pragma mark - Conversation
80 
92 - (NSArray *)getAllConversations;
93 
94 
114 - (EMConversation *)getConversation:(NSString *)aConversationId
115  type:(EMConversationType)aType
116  createIfNotExist:(BOOL)aIfCreate;
117 
134 - (void)deleteConversation:(NSString *)aConversationId
135  isDeleteMessages:(BOOL)aIsDeleteMessages
136  completion:(void (^)(NSString *aConversationId, EMError *aError))aCompletionBlock;
137 
154 - (void)deleteConversations:(NSArray *)aConversations
155  isDeleteMessages:(BOOL)aIsDeleteMessages
156  completion:(void (^)(EMError *aError))aCompletionBlock;
157 
173 - (void)importConversations:(NSArray *)aConversations
174  completion:(void (^)(EMError *aError))aCompletionBlock;
175 
176 #pragma mark - Message
177 
178 - (EMMessage *)getMessageWithMessageId:(NSString *)aMessageId;
179 
195 - (NSString *)getMessageAttachmentPath:(NSString *)aConversationId;
196 
211 - (void)importMessages:(NSArray *)aMessages
212  completion:(void (^)(EMError *aError))aCompletionBlock;
213 
228 - (void)updateMessage:(EMMessage *)aMessage
229  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock;
230 
249 - (void)sendMessageReadAck:(NSString *)aMessageId
250  toUser:(NSString *)aUsername
251  completion:(void (^)(EMError *aError))aCompletionBlock;
252 
253 
274 - (void)sendGroupMessageReadAck:(NSString *)aMessageId
275  toGroup:(NSString *)aGroupId
276  content:(NSString *)aContent
277  completion:(void (^)(EMError *aError))aCompletionBlock;
278 
279 
297 - (void)recallMessageWithMessageId:(NSString *)aMessageId
298  completion:(void (^)(EMError *aError))aCompletionBlock;
299 
300 
316 - (void)sendMessage:(EMMessage *)aMessage
317  progress:(void (^)(int progress))aProgressBlock
318  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
319 
335 - (void)resendMessage:(EMMessage *)aMessage
336  progress:(void (^)(int progress))aProgressBlock
337  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
338 
355 - (void)downloadMessageThumbnail:(EMMessage *)aMessage
356  progress:(void (^)(int progress))aProgressBlock
357  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
358 
376 - (void)downloadMessageAttachment:(EMMessage *)aMessage
377  progress:(void (^)(int progress))aProgressBlock
378  completion:(void (^)(EMMessage *message, EMError *error))aCompletionBlock;
379 
380 
381 
406 - (EMCursorResult *)fetchHistoryMessagesFromServer:(NSString *)aConversationId
407  conversationType:(EMConversationType)aConversationType
408  startMessageId:(NSString *)aStartMessageId
409  pageSize:(int)aPageSize
410  error:(EMError **)pError;
411 
412 
435 - (void)asyncFetchHistoryMessagesFromServer:(NSString *)aConversationId
436  conversationType:(EMConversationType)aConversationType
437  startMessageId:(NSString *)aStartMessageId
438  pageSize:(int)aPageSize
439  completion:(void (^)(EMCursorResult *aResult, EMError *aError))aCompletionBlock;
440 
441 - (void)asyncFetchGroupMessageAcksFromServer:(NSString *)aMessageId
442  groupId:(NSString *)aGroupId
443  startGroupAckId:(NSString *)aGroupAckId
444  pageSize:(int)aPageSize
445  completion:(void (^)(EMCursorResult *aResult, EMError *error, int totalCount))aCompletionBlock;
446 
447 #pragma mark - EM_DEPRECATED_IOS 3.6.1
448 
465 - (void)sendMessageReadAck:(EMMessage *)aMessage
466  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock EM_DEPRECATED_IOS(3_3_0, 3_6_1, "Use -[IEMChatManager sendMessageReadAck:toUser:completion:]");
467 
468 
486 - (void)recallMessage:(EMMessage *)aMessage
487  completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock EM_DEPRECATED_IOS(3_3_0, 3_6_1, "Use -[IEMChatManager recallMessageWithMessageId:completion:]");
488 
489 
490 #pragma mark - EM_DEPRECATED_IOS 3.2.3
491 
503 - (void)addDelegate:(id<EMChatManagerDelegate>)aDelegate EM_DEPRECATED_IOS(3_1_0, 3_2_2, "Use -[IEMChatManager addDelegate:delegateQueue:]");
504 
505 #pragma mark - EM_DEPRECATED_IOS < 3.2.3
506 
522 - (NSArray *)loadAllConversationsFromDB __deprecated_msg("Use -getAllConversations");
523 
541 - (BOOL)deleteConversation:(NSString *)aConversationId
542  deleteMessages:(BOOL)aDeleteMessage __deprecated_msg("Use -deleteConversation:isDeleteMessages:completion:");
543 
561 - (BOOL)deleteConversations:(NSArray *)aConversations
562  deleteMessages:(BOOL)aDeleteMessage __deprecated_msg("Use -deleteConversations:isDeleteMessages:completion:");
563 
579 - (BOOL)importConversations:(NSArray *)aConversations __deprecated_msg("Use -importConversations:completion:");
580 
596 - (BOOL)importMessages:(NSArray *)aMessages __deprecated_msg("Use -importMessages:completion:");
597 
613 - (BOOL)updateMessage:(EMMessage *)aMessage __deprecated_msg("Use -updateMessage:completion:");
614 
630 - (void)asyncSendReadAckForMessage:(EMMessage *)aMessage __deprecated_msg("Use -sendMessageReadAck:completion:");
631 
652 - (void)asyncSendMessage:(EMMessage *)aMessage
653  progress:(void (^)(int progress))aProgressCompletion
654  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -sendMessage:progress:completion:");
655 
675 - (void)asyncResendMessage:(EMMessage *)aMessage
676  progress:(void (^)(int progress))aProgressCompletion
677  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -resendMessage:progress:completion:");
678 
698 - (void)asyncDownloadMessageThumbnail:(EMMessage *)aMessage
699  progress:(void (^)(int progress))aProgressCompletion
700  completion:(void (^)(EMMessage * message, EMError *error))aCompletion __deprecated_msg("Use -downloadMessageThumbnail:progress:completion:");
701 
721 - (void)asyncDownloadMessageAttachments:(EMMessage *)aMessage
722  progress:(void (^)(int progress))aProgressCompletion
723  completion:(void (^)(EMMessage *message, EMError *error))aCompletion __deprecated_msg("Use -downloadMessageAttachment:progress:completion");
748 - (void)loadMessagesWithType:(EMMessageBodyType)aType
749  timestamp:(long long)aTimestamp
750  count:(int)aCount
751  fromUser:(NSString*)aUsername
752  searchDirection:(EMMessageSearchDirection)aDirection
753  completion:(void (^)(NSArray *aMessages, EMError *aError))aCompletionBlock;
754 
779 - (void)loadMessagesWithKeyword:(NSString*)aKeywords
780  timestamp:(long long)aTimestamp
781  count:(int)aCount
782  fromUser:(NSString*)aSender
783  searchDirection:(EMMessageSearchDirection)aDirection
784  completion:(void (^)(NSArray *aMessages, EMError *aError))aCompletionBlock;
785 
786 @end
EMConversation
Definition: EMConversation.h:54
IEMChatManager-p
Definition: IEMChatManager.h:44
EMCursorResult
Definition: EMCursorResult.h:24
EMError
Definition: EMError.h:26
-[IEMChatManager-p __deprecated_msg]
"Use -getAllConversations" __deprecated_msg()
EMChatManagerDelegate-p
Definition: EMChatManagerDelegate.h:27
-[IEMChatManager-p getAllConversations]
NSArray * getAllConversations()
EMMessage
Definition: EMMessage.h:65