EMConversation.h

 
#import <Foundation/Foundation.h>
 
#import "EMMessageBody.h"
#import "EMCursorResult.h"
#import "EMSilentModeParam.h"
 
typedef NS_ENUM(NSInteger, EMConversationType) {
    EMConversationTypeChat = 0,    
    EMConversationTypeGroupChat,    
    EMConversationTypeChatRoom,      
};
 
typedef NS_ENUM(NSInteger, EMMarkType) {
    EMMarkType0 = 0,
    EMMarkType1 = 1,
    EMMarkType2 = 2,
    EMMarkType3 = 3,
    EMMarkType4 = 4,
    EMMarkType5 = 5,
    EMMarkType6 = 6,
    EMMarkType7 = 7,
    EMMarkType8 = 8,
    EMMarkType9 = 9,
    EMMarkType10 = 10,
    EMMarkType11 = 11,
    EMMarkType12 = 12,
    EMMarkType13 = 13,
    EMMarkType14 = 14,
    EMMarkType15 = 15,
    EMMarkType16 = 16,
    EMMarkType17 = 17,
    EMMarkType18 = 18,
    EMMarkType19 = 19,
};
 
typedef NS_ENUM(NSInteger, EMMessageSearchDirection) {
    EMMessageSearchDirectionUp  = 0,    
    EMMessageSearchDirectionDown        
};
 
typedef NS_ENUM(NSInteger, EMMessageSearchScope) {
    EMMessageSearchScopeContent  = 0,   
    EMMessageSearchScopeExt,           
    EMMessageSearchScopeAll           
};
 
@class EMChatMessage;
@class EMError;
 
@interface EMConversation : NSObject
-(instancetype _Nonnull ) init NS_UNAVAILABLE;
@property (nonatomic, copy, readonly) NSString *conversationId;
 
@property (nonatomic, assign, readonly) EMConversationType type;
 
@property (nonatomic, assign, readonly) int unreadMessagesCount;
 
@property (nonatomic, assign, readonly) int messagesCount;
 
@property (nonatomic, copy)   NSDictionary *ext;
 
@property (nonatomic, assign) BOOL isChatThread;
 
@property (readonly) BOOL isPinned;
 
@property (readonly) int64_t pinnedTime;
 
@property (nonatomic, strong, readonly) EMChatMessage *latestMessage;
 
@property (nonatomic, readonly) NSArray<NSNumber*>* marks;
 
@property (nonatomic, readonly) EMPushRemindType disturbType;
 
- (EMChatMessage * _Nullable)lastReceivedMessage;
 
- (NSString* _Nullable)conversationName;
 
- (NSString* _Nullable)conversationAvatar;
 
- (void)insertMessage:(EMChatMessage *_Nonnull)aMessage
                error:(EMError ** _Nullable)pError;
 
- (void)appendMessage:(EMChatMessage *_Nonnull)aMessage
                error:(EMError **_Nullable)pError;
 
- (void)deleteMessageWithId:(NSString *_Nonnull)aMessageId
                      error:(EMError ** _Nullable)pError;
 
- (void)deleteAllMessages:(EMError ** _Nullable)pError;
 
 
- (void)removeMessagesFromServerMessageIds:(NSArray <__kindof NSString*>*_Nonnull)messageIds completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;
- (void)removeMessagesFromServerWithTimeStamp:(NSTimeInterval)beforeTimeStamp completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;
 
- (void)updateMessageChange:(EMChatMessage *_Nonnull)aMessage
                      error:(EMError ** _Nullable)pError;
- (NSArray<EMChatMessage*>* _Nullable)pinnedMessages;
 
 
#pragma mark - Load Messages Methods
 
- (EMChatMessage * _Nullable)loadMessageWithId:(NSString * _Nonnull)aMessageId
                           error:(EMError ** _Nullable)pError;
 
- (NSArray<EMChatMessage *> * _Nullable)loadMessagesStartFromId:(NSString * _Nullable)aMessageId
                          count:(int)aCount
                searchDirection:(EMMessageSearchDirection)aDirection;
 
- (void)loadMessagesStartFromId:(NSString * _Nullable)aMessageId
                          count:(int)aCount
                searchDirection:(EMMessageSearchDirection)aDirection
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (NSArray<EMChatMessage *> * _Nullable)loadMessagesWithType:(EMMessageBodyType)aType
                                                   timestamp:(long long)aTimestamp
                                                       count:(int)aCount
                                                    fromUser:(NSString* _Nullable)aUsername
                                             searchDirection:(EMMessageSearchDirection)aDirection;
 
- (void)loadMessagesWithType:(EMMessageBodyType)aType
                   timestamp:(long long)aTimestamp
                       count:(int)aCount
                    fromUser:(NSString* _Nullable)aUsername
             searchDirection:(EMMessageSearchDirection)aDirection
                  completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
- (void)searchMessagesWithTypes:(NSArray <NSNumber*> *_Nonnull)aTypes
                   timestamp:(long long)aTimestamp
                       count:(int)aCount
                    fromUser:(NSString* _Nullable)aUsername
             searchDirection:(EMMessageSearchDirection)aDirection
                  completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
- (NSArray<EMChatMessage *> * _Nullable)loadMessagesWithKeyword:(NSString* _Nullable)aKeywords
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString* _Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection;
 
- (void)loadMessagesWithKeyword:(NSString* _Nullable)aKeywords
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString* _Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (void)loadMessagesWithKeyword:(NSString* _Nullable)aKeywords
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString* _Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection
                          scope:(EMMessageSearchScope)aScope
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock __deprecated_msg("Use -loadMessagesWithKeyword:timestamp:count:fromUsers:searchDirection:scope:completion: instead");
 
 
 
- (void)loadMessagesWithKeyword:(NSString* _Nullable)aKeywords
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUsers:(NSArray<NSString*>* _Nullable)senders
                searchDirection:(EMMessageSearchDirection)aDirection
                          scope:(EMMessageSearchScope)aScope
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (NSArray<EMChatMessage *> * _Nullable)loadCustomMsgWithKeyword:(NSString*)aKeywords
                       timestamp:(long long)aTimestamp
                           count:(int)aCount
                        fromUser:(NSString* _Nullable)aSender
                 searchDirection:(EMMessageSearchDirection)aDirection;
 
- (void)loadCustomMsgWithKeyword:(NSString* _Nullable)aKeywords
                       timestamp:(long long)aTimestamp
                           count:(int)aCount
                        fromUser:(NSString* _Nullable)aSender
                 searchDirection:(EMMessageSearchDirection)aDirection
                      completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (NSArray<EMChatMessage *> * _Nullable)loadMessagesFrom:(long long)aStartTimestamp
                      to:(long long)aEndTimestamp
                   count:(int)aCount;
 
- (void)loadMessagesFrom:(long long)aStartTimestamp
                      to:(long long)aEndTimestamp
                   count:(int)aCount
              completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (EMError* _Nullable)removeMessagesStart:(NSInteger)aStartTimestamp
                                       to:(NSInteger)aEndTimestamp;
 
- (NSInteger)getMessageCountStart:(NSInteger)aStartTimestamp
                               to:(NSInteger)aEndTimestamp;
@end