MsgService

```
public interface MsgService
```
云信消息服务接口

字段概要

字段
限定符和类型	字段和说明
`static java.lang.String`	`MSG_CHATTING_ACCOUNT_ALL` 目前没有与任何人对话，但能看到消息提醒（比如在消息列表界面），不需要在状态栏做消息通知
`static java.lang.String`	`MSG_CHATTING_ACCOUNT_NONE` 目前没有与任何人对话，需要状态栏消息通知

方法概要

所有方法实例方法抽象方法已过时的方法
限定符和类型	方法和说明
`InvocationFuture<CollectInfo>`	`addCollect(int type, java.lang.String date, java.lang.String ext, java.lang.String uniqueId)` 添加一条收藏
`InvocationFuture<java.lang.Long>`	`addMsgPin(IMMessage msg, java.lang.String ext)` PIN一条消息
`InvocationFuture<java.lang.Void>`	`addQuickComment(IMMessage msg, long replyType, java.lang.String ext)` 增加一条快捷评论
`InvocationFuture<java.lang.Long>`	`addQuickComment(IMMessage msg, long replyType, java.lang.String ext, boolean needPush, boolean needBadge, java.lang.String pushTitle, java.lang.String pushContent, java.util.Map<java.lang.String,java.lang.Object> pushPayload)` 增加一条快捷评论
`InvocationFuture<StickTopSessionInfo>`	`addStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)` 添加一个置顶会话
`InvocationFuture<java.lang.Void>`	`cancelUploadAttachment(IMMessage imMessage)` 取消上传消息附件（图片、视频、文件类型的），如果附件已经上传成功，操作将会失败。
`LocalAntiSpamResult`	`checkLocalAntiSpam(java.lang.String content, java.lang.String replacement)` 检验本地反垃圾词库
`void`	`clearAllUnreadCount()` 将所有联系人的未读数清零(标记已读) 调用该接口后，会触发`MsgServiceObserve.observeRecentContact(Observer, boolean)` 通知
`void`	`clearChattingHistory(java.lang.String account, SessionTypeEnum sessionType)` 清除与指定用户的所有消息记录，且不在数据库记录此次操作
`void`	`clearChattingHistory(java.lang.String account, SessionTypeEnum sessionType, boolean ignore)` 清除与指定用户的所有本地消息记录
`InvocationFuture<java.lang.Void>`	`clearMsgDatabase(boolean clearRecent)` 清空消息数据库的所有消息记录。
`void`	`clearServerHistory(java.lang.String sessionId, boolean deleteRoam)` 清空点对点历史消息
`void`	`clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType)` 清空点对点历史消息，默认删除漫游消息
`void`	`clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType, boolean deleteRoam)` 已过时。仅当P2P时，支持保留漫游消息。如果要保留漫游消息，使用`clearServerHistory(String, boolean)` 如果不保留蛮有消息，使用`clearServerHistory(String, SessionTypeEnum)`
`void`	`clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType, boolean sync, java.lang.String ext)` 清空历史消息
`InvocationFuture<java.util.List<SessionAckInfo>>`	`clearUnreadCount(java.util.List<<any>> sessionKeyList)` 将指定最近联系人的未读数清零(标记已读)。
`InvocationFuture<java.util.List<SessionAckInfo>>`	`clearUnreadCount(SessionTypeEnum sessionType)` 将指定会话类型的未读数清零(标记已读)。
`InvocationFuture<java.lang.Void>`	`clearUnreadCount(java.lang.String account, SessionTypeEnum sessionType)` 将指定最近联系人的未读数清零(标记已读)。
`RecentContact`	`createEmptyRecentContact(java.lang.String contactId, SessionTypeEnum sessionType, long tag, long time, boolean saveToDB)` 创建一条空的联系人会话
`RecentContact`	`createEmptyRecentContact(java.lang.String contactId, SessionTypeEnum sessionType, long tag, long time, boolean saveToDB, boolean withLastMsg)` 创建一条空的联系人会话
`void`	`deleteChattingHistory(IMMessage message)` 删除一条消息记录，并在数据库记录此操作从云端拉取消息时，如果本地有删除该消息的操作记录，则该消息不会入库删除标记会被清除标记覆盖
`void`	`deleteChattingHistory(IMMessage message, boolean ignore)` 删除一条消息记录
`void`	`deleteChattingHistory(java.util.List<IMMessage> msgList, boolean ignore)` 删除多条消息记录
`InvocationFuture<java.lang.Long>`	`deleteMsgSelf(IMMessage msg, java.lang.String ext)` 单向删除一条消息
`InvocationFuture<java.lang.Long>`	`deleteMsgSelf(java.util.List<IMMessage> msgList, java.lang.String ext)` 单向删除多条消息
`InvocationFuture<java.lang.Void>`	`deleteMySession(java.lang.String[] sessionIdArr)` 【会话服务】删除会话
`void`	`deleteRangeHistory(java.lang.String account, SessionTypeEnum sessionType, long startTime, long endTime)` 根据时间范围删除本地历史消息(startTime， entTime), 开区间，不包括两个端点，大于startTime，小于endTime
`void`	`deleteRecentContact(RecentContact recent)` 从最近联系人会话列表中删除一项，既删本地也删漫游。
`InvocationFuture<java.lang.Void>`	`deleteRecentContact(java.lang.String account, SessionTypeEnum sessionType, DeleteTypeEnum deleteType, boolean sendAck)` 删除最近联系人记录。
`void`	`deleteRecentContact2(java.lang.String account, SessionTypeEnum sessionType)` 删除最近联系人记录，既删本地也删漫游。
`InvocationFuture<java.lang.Void>`	`deleteRoamingRecentContact(java.lang.String contactId, SessionTypeEnum sessionTypeEnum)` 删除指定最近联系人的漫游消息。
`void`	`deleteRoamMsgHasMoreTag(java.lang.String sessionId, SessionTypeEnum sessionType)` 删除是否有更多漫游的标记
`AbortableFuture<java.lang.Void>`	`downloadAttachment(IMMessage msg, boolean thumb)` 正常情况收到消息后附件会自动下载。
`boolean`	`everBeenDeleted(IMMessage message)` 消息是否曾被从本地删除
`AbortableFuture<java.lang.Void>`	`exportAllMessage(IMsgExportProcessor exportProcessor, boolean safeMode)` 导出本地db 的所有消息并上传给服务器，对应于导入消息的操作（常用于端到端的历史消息牵移），如果有云端消息记录，不建议使用这个接口导入参考`importAllMessage(IMsgImportProcessor, boolean safeMode)` 只会导出以下类型的消息：文本消息、图片消息、音频消息、视频消息、文件消息、自定义消息整个过程如下： step1 : 消息转换成文件 step2 : 压缩文件（用户自定义过程） step3 : 加密文件（用户自定义过程） step4 : 上传文件错误码： DB中没有数据 : `MigrationConstant.EXPORT_ERR_DB_EMPTY` 本地消息格式化失败 : `MigrationConstant.EXPORT_ERR_LOCAL_FORMAT` 文件压缩失败(用户自定义过程) : `MigrationConstant.EXPORT_ERR_USER_CUSTOM_ZIP` 消息导出时，文件加密失败(用户自定义过程) : `MigrationConstant.EXPORT_ERR_USER_CUSTOM_ENCRYPT` 上传文件失败 : `MigrationConstant.EXPORT_ERR_UPLOAD_FILE` 消息导出时，本地有消息，但是都被过滤了 : `MigrationConstant.EXPORT_ERR_EMPTY_AFTER_FILTER`
`InvocationFuture<GetMessagesDynamicallyResult>`	`getMessagesDynamically(GetMessagesDynamicallyParam param)` 动态途径获取消息，默认从本地获取，动态能力需要开通功能，并在同步完成后生效
`int`	`getTotalUnreadCount()` 获取未读数总数
`int`	`getTotalUnreadCount(boolean notify)` 获取未读数总数
`int`	`getUnreadCountBySessionType(SessionTypeEnum sessionType)` 获取指定会话类型的总未读数
`AbortableFuture<java.lang.Void>`	`importAllMessage(IMsgImportProcessor iMsgImportProcessor, boolean safeMode)` 导入已经导出的消息（常用于端到端的历史消息牵移），导出参考`exportAllMessage(IMsgExportProcessor, boolean safeMode)` * 整个过程如下： step1 : 请求服务器，下载备份文件 step2 : 解密文件（用户自定义过程） step3 : 解压缩文件（用户自定义过程） step4 : 解析文件错误码：服务端上没有备份记录 : `MigrationConstant.IMPORT_ERR_NO_BACKUP` 服务端返回了备份记录，可是为空 : `MigrationConstant.IMPORT_ERR_RECORD_EMPTY` 文件下载失败 : `MigrationConstant.IMPORT_ERR_DOWN_FILE` 文件解密失败(用户自定义过程) : `MigrationConstant.IMPORT_ERR_CUSTOM_DECRYPT` 文件解压缩失败(用户自定义过程) : `MigrationConstant.IMPORT_ERR_CUSTOM_UNZIP` 文件格式错误 : `MigrationConstant.IMPORT_ERR_FILE_FORMAT` 部分成功: `MigrationConstant.IMPORT_ERR_PART_SUCCESS`
`InvocationFuture<java.lang.Void>`	`importRecentSessions(java.util.List<<any>> sessions)` 导入最近会话，批量导入，仅支持 contactId 和 sessionType 两个字段
`InvocationFuture<java.lang.Void>`	`insertLocalMessage(IMMessage msg, java.lang.String fromAccount)` 插入消息到本地数据库，且通知更新UI界面，但不发送到服务器端。
`boolean`	`isStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType)` 会话是否被置顶，若参数不合法，或者会话不存在，返回false
`void`	`migrateMessages(java.lang.String from, java.lang.String to, boolean changeFrom)` 迁移消息聊天记录。
`InvocationFuture<java.util.List<IMMessage>>`	`pullHistoryById(java.util.List<MessageKey> msgKeyList, boolean persist)` 根据消息ID等信息从服务器批量查询历史消息
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistory(IMMessage anchor, int limit, boolean persist)` 从服务器拉取消息历史记录。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistory(IMMessage anchor, int limit, boolean persist, boolean persistClear)` 从服务器拉取消息历史记录。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistory(MsgFullKeywordSearchConfig config)` 云端历史消息全文检索
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryEx(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, boolean persist)` 从服务器拉取消息历史记录。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes)` 从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes, boolean persist)` 从服务器拉取消息历史记录，可以指定查询的消息类型，结果是否保存到本地消息数据库。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes, boolean persist, boolean persistClear)` 从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes, boolean persist, boolean persistClear, IMMessageFilter customFilter)` 从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes, boolean persist, boolean persistClear, IMMessageFilter customFilter, boolean updateUnread)` 从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
`InvocationFuture<java.util.List<IMMessage>>`	`pullMessageHistoryOrderByTime(MsgTimingFullKeywordSearchConfig config)` 云端历史消息全文检索(按时间排序，不按会话分组)
`InvocationFuture<CollectInfoPage>`	`queryCollect(CollectInfo anchor, long toTime, int limit, QueryDirectionEnum direction)` 从服务端分页查询收藏列表
`InvocationFuture<CollectInfoPage>`	`queryCollect(CollectInfo anchor, long toTime, int limit, QueryDirectionEnum direction, int type, boolean persist)` 从服务的分页查询收藏列表
`InvocationFuture<CollectInfoPage>`	`queryCollect(int limit)` 从服务查询收藏列表
`IMMessage`	`queryLastMessage(java.lang.String account, SessionTypeEnum sessionType)` 查询同指定用户的最近一条消息
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageList(java.lang.String account, SessionTypeEnum sessionType, long offset, int limit)` 已过时。请使用 `queryMessageListEx(IMMessage, QueryDirectionEnum, int, boolean)` 来替代。
`java.util.List<IMMessage>`	`queryMessageListByServerIdBlock(java.util.List<java.lang.String> serverIds)` 通过 Server ID 批量获取IMMessage(同步版本) 注意：一个ServerId可能对应多条消息
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListBySubtype(MsgTypeEnum msgTypeEnum, IMMessage anchor, int limit, int subtype)` 通过消息子类型查询本地消息记录（异步版本）
`java.util.List<IMMessage>`	`queryMessageListBySubtypeBlock(MsgTypeEnum msgTypeEnum, IMMessage anchor, int limit, int subtype)` 通过消息子类型查询本地消息记录（同步版本）
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListByType(MsgTypeEnum msgTypeEnum, IMMessage anchor, int limit)` 通过消息类型从本地消息数据库中查询消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListByType(MsgTypeEnum msgTypeEnum, java.lang.Long maxTime, int limit)` 通过消息类型查询所有消息记录，
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListByTypes(java.util.List<MsgTypeEnum> types, IMMessage anchor, long toTime, QueryDirectionEnum direction, int limit, boolean asc)` 已过时。
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListByTypesV2(java.util.List<MsgTypeEnum> types, IMMessage anchor, long toTime, QueryDirectionEnum direction, int limit, boolean asc)` 根据起始、截止时间点以及查询方向从本地消息数据库中查询指定消息类型的消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListByUuid(java.util.List<java.lang.String> uuids)` 通过uuid批量获取IMMessage
`java.util.List<IMMessage>`	`queryMessageListByUuidBlock(java.util.List<java.lang.String> uuids)` 通过uuid批量获取IMMessage(同步版本)
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListEx(IMMessage anchor, QueryDirectionEnum direction, int limit, boolean asc)` 根据锚点和方向从本地消息数据库中查询消息历史。
`java.util.List<IMMessage>`	`queryMessageListExBlock(IMMessage anchor, QueryDirectionEnum direction, int limit, boolean asc)` 根据锚点和方向从本地消息数据库中查询消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`queryMessageListExTime(IMMessage anchor, long toTime, QueryDirectionEnum direction, int limit)` 根据起始、截止时间点以及查询方向从本地消息数据库中查询消息历史。
`java.util.List<MsgPinDbOption>`	`queryMsgPinBlock(java.lang.String sessionId, SessionTypeEnum sessionType)` 本地获取会话的PIN消息列表
`InvocationFuture<RecentSession>`	`queryMySession(java.lang.String sessionId)` 【会话服务】获取某一个会话
`InvocationFuture<RecentSessionList>`	`queryMySessionList(long minTimestamp, java.lang.Long maxTimestamp, java.lang.Integer needLastMsg, java.lang.Integer limit, java.lang.Integer hasMore)` 已过时。
`InvocationFuture<RecentSessionList>`	`queryMySessionList(QueryMySessionOption option)` 【会话服务】增量获取会话列表，增量+翻页
`InvocationFuture<java.util.List<QuickCommentOptionWrapper>>`	`queryQuickComment(java.util.List<IMMessage> msgList)` 获取快捷评论列表
`RecentContact`	`queryRecentContact(java.lang.String contactId, SessionTypeEnum sessionType)` 根据 contactId 与 sessionType 从db 中查询联系人会话记录。
`InvocationFuture<java.util.List<RecentContact>>`	`queryRecentContacts()` 查询最近联系人会话列表数据
`InvocationFuture<java.util.List<RecentContact>>`	`queryRecentContacts(int limit)` 查询最近联系人会话列表数据, 可以设置limit，防止本地会话过多时，导致第一次加载慢
`InvocationFuture<java.util.List<RecentContact>>`	`queryRecentContacts(MsgTypeEnum filterMsgType)` 查询联系人最近会话列表数据, 最近一条不等于过滤消息类型， eg：需要过滤MsgTypeEnum.notification, 则传入改type note ：该方法返回未读为全量消息未读
`InvocationFuture<java.util.List<RecentContact>>`	`queryRecentContacts(RecentContact anchor, QueryDirectionEnum direction, int limit)` 查询最近联系人会话列表数据，可按时间逆序或者正序查询指定数量的最新会话列表数据
`InvocationFuture<java.util.List<RecentContact>>`	`queryRecentContacts(java.util.Set<MsgTypeEnum> filterMsgTypeSet)` 查询联系人最近会话列表数据, 最近一条不在过滤消息类型中， eg：需要过滤MsgTypeEnum.notification, 则传入改type note ：该方法返回未读为全量消息未读
`java.util.List<RecentContact>`	`queryRecentContactsBlock()` 查询最近联系人会话列表数据(同步版本)
`java.util.List<RecentContact>`	`queryRecentContactsBlock(int limit)` 查询最近联系人会话列表数据(同步版本)，可以设置limit，防止本地会话过多时，导致第一次加载慢
`java.util.List<RecentContact>`	`queryRecentContactsBlock(MsgTypeEnum filterMsgType)` 查询联系人最近会话列表数据(同步版本)，最近一条不等于过滤消息类型，该方法可能会执行较长时间，建议使用异步版本, note ：该方法返回未读为全量消息未读
`java.util.List<RecentContact>`	`queryRecentContactsBlock(RecentContact anchor, QueryDirectionEnum direction, int limit)` 查询最近联系人会话列表数据(同步版本)，可按时间逆序或者正序查询指定数量的最新会话列表数据
`java.util.List<RecentContact>`	`queryRecentContactsBlock(java.util.Set<MsgTypeEnum> filterMsgTypeSet)` 查询联系人最近会话列表数据(同步版本)，最近一条不在过滤消息类型中，该方法可能会执行较长时间，建议使用异步版本, note ：该方法返回未读为全量消息未读
`int`	`queryReplyCountInThreadTalkBlock(IMMessage msg)` 本地获取某thread消息的回复消息的条数，thread消息不被计入总数
`InvocationFuture<java.lang.Long>`	`queryRoamMsgHasMoreTagServerId(java.lang.String sessionId, SessionTypeEnum sessionType)` 获取是否有更多漫游消息标记的serverid，如果没有，回调0L
`long`	`queryRoamMsgHasMoreTagServerIdBlock(java.lang.String sessionId, SessionTypeEnum sessionType)` 获取是否有更多漫游消息标记的serverid，如果没有，回调0L（同步接口）
`InvocationFuture<java.lang.Long>`	`queryRoamMsgHasMoreTime(java.lang.String sessionId, SessionTypeEnum sessionType)` 获取是否有更多漫游消息标记的时间戳，如果没有，回调0L
`long`	`queryRoamMsgHasMoreTimeBlock(java.lang.String sessionId, SessionTypeEnum sessionType)` 获取是否有更多漫游消息标记的时间戳，如果没有，回调0L（同步接口）
`java.util.List<StickTopSessionInfo>`	`queryStickTopSessionBlock()` 获取置顶会话信息的列表
`InvocationFuture<ThreadTalkHistory>`	`queryThreadTalkHistory(IMMessage anchor, long fromTime, long toTime, int limit, QueryDirectionEnum direction, boolean persist)` 查询thread聊天云端历史（支持p2p、群、超大群）
`InvocationFuture<java.util.List<IMMessage>>`	`queryUnreadMessageList(java.lang.String sessionId, SessionTypeEnum sessionType)` 根据会话ID和会话类型查找未读消息列表
`java.util.List<IMMessage>`	`queryUnreadMessageListBlock(java.lang.String sessionId, SessionTypeEnum sessionType)` 根据会话ID和会话类型查找未读消息列表（同步版本）
`void`	`registerCustomAttachmentParser(MsgAttachmentParser customParser)` 如果第三方app需要自定义的附件消息类型，再次注册自己的附件解析器。
`void`	`registerIMMessageFilter(IMMessageFilter filter)` 注册通知消息过滤器
`void`	`registerShouldShowNotificationWhenRevokeFilter(ShowNotificationWhenRevokeFilter filter)` 注册是否在撤回消息时展示通知的过滤器
`InvocationFuture<java.lang.Integer>`	`removeCollect(java.util.List<<any>> collectInfo)` 批量移除收藏
`InvocationFuture<java.lang.Long>`	`removeMsgPin(IMMessage msg, java.lang.String ext)` 移除一条消息的PIN
`InvocationFuture<java.lang.Void>`	`removeQuickComment(IMMessage msg, long replyType, java.lang.String ext)` 删除一条快捷评论
`InvocationFuture<java.lang.Long>`	`removeQuickComment(IMMessage msg, long replyType, java.lang.String ext, boolean needPush, boolean needBadge, java.lang.String pushTitle, java.lang.String pushContent, java.util.Map<java.lang.String,java.lang.Object> pushPayload)` 删除一条快捷评论
`InvocationFuture<java.lang.Void>`	`removeStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)` 删除一个置顶会话
`InvocationFuture<java.lang.Void>`	`replyMessage(IMMessage msg, IMMessage replyMsg, boolean resend)` 回复消息。
`InvocationFuture<java.lang.Void>`	`revokeMessage(IMMessage message)` 消息撤回，默认没有第三方推送（包括IOS平台的推送），参考`revokeMessageEx(IMMessage, String, Map)`
`InvocationFuture<java.lang.Void>`	`revokeMessage(IMMessage message, java.lang.String customApnsText, java.util.Map<java.lang.String,java.lang.Object> pushPayload, boolean shouldNotifyBeCount)` 消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考`NIMClient.toggleRevokeMessageNotification(boolean on)`
`InvocationFuture<java.lang.Void>`	`revokeMessage(IMMessage message, java.lang.String customApnsText, java.util.Map<java.lang.String,java.lang.Object> pushPayload, boolean shouldNotifyBeCount, java.lang.String postscript)` 消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考`NIMClient.toggleRevokeMessageNotification(boolean on)`
`InvocationFuture<java.lang.Void>`	`revokeMessage(IMMessage message, java.lang.String customApnsText, java.util.Map<java.lang.String,java.lang.Object> pushPayload, boolean shouldNotifyBeCount, java.lang.String postscript, java.lang.String attach)` 消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考`NIMClient.toggleRevokeMessageNotification(boolean on)`
`InvocationFuture<java.lang.Void>`	`revokeMessageEx(IMMessage message, java.lang.String customApnsText, java.util.Map<java.lang.String,java.lang.Object> pushPayload)` 消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送），如果想要关闭App内的返回消息提醒，参考`NIMClient.toggleRevokeMessageNotification(boolean on)`
`InvocationFuture<java.lang.Void>`	`saveMessageToLocal(IMMessage msg, boolean notify)` 保存消息到本地数据库，但不发送到服务器端。
`InvocationFuture<java.lang.Void>`	`saveMessageToLocalEx(IMMessage msg, boolean notify, long time)` 保存消息到本地数据库，但不发送到服务器端。
`InvocationFuture<java.util.List<IMMessage>>`	`searchAllMessage(MsgSearchOption option)` 从本地消息数据库全局搜索消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`searchAllMessageHistory(java.lang.String keyword, java.util.List<java.lang.String> fromAccounts, long time, int limit)` 从本地消息数据库搜索消息历史。
`InvocationFuture<java.util.List<MsgIndexRecord>>`	`searchAllSession(java.lang.String query, int limit)` 检索所有会话，返回每个会话与检索串匹配的消息数及最近一条匹配的消息记录。
`java.util.List<MsgIndexRecord>`	`searchAllSessionBlock(java.lang.String query, int limit)` 检索所有会话，返回每个会话与检索串匹配的消息数及最近一条匹配的消息记录。
`InvocationFuture<java.util.List<IMMessage>>`	`searchMessage(SessionTypeEnum sessionType, java.lang.String sessionId, MsgSearchOption option)` 从本地消息数据库搜索消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`searchMessageHistory(java.lang.String keyword, java.util.List<java.lang.String> fromAccounts, IMMessage anchor, int limit)` 从本地消息数据库搜索消息历史。
`InvocationFuture<java.util.List<IMMessage>>`	`searchMessageHistory(java.lang.String keyword, java.util.List<java.lang.String> fromAccounts, IMMessage anchor, QueryDirectionEnum direction, int limit)` 从本地消息数据库搜索消息历史。
`InvocationFuture<java.util.ArrayList<IMMessage>>`	`searchRoamingMsg(java.lang.String otherAccid, long fromTime, long endTime, java.lang.String keyword, int limit, boolean reverse)` 云端聊天记录关键词查询
`InvocationFuture<java.util.List<MsgIndexRecord>>`	`searchSession(java.lang.String query, SessionTypeEnum sessionType, java.lang.String sessionId)` 检索指定的会话，返回该会话中与检索串匹配的所有消息记录。
`java.util.List<MsgIndexRecord>`	`searchSessionBlock(java.lang.String query, SessionTypeEnum sessionType, java.lang.String sessionId)` 检索指定的会话，返回该会话中与检索串匹配的所有消息记录。
`InvocationFuture<java.lang.Void>`	`sendCustomNotification(CustomNotification notification)` 发送一条指令消息。
`AbortableFuture<FileAttachment>`	`sendFile(FileAttachment attachment)` 上传文件附件
`InvocationFuture<java.lang.Void>`	`sendMessage(IMMessage msg, boolean resend)` 发送消息。
`InvocationFuture<java.lang.Void>`	`sendMessageReceipt(java.lang.String sessionId, IMMessage message)` 发送P2P消息已读回执
`void`	`setChattingAccount(java.lang.String account, SessionTypeEnum sessionType)` 设置当前正在聊天的对象。
`InvocationFuture<MsgPinSyncResponseOptionWrapper>`	`syncMsgPin(SessionTypeEnum sessionType, java.lang.String sessionId, long timestamp)` 同步会话的PIN信息
`AbortableFuture<java.lang.String>`	`transVoiceToText(java.lang.String voiceUrl, java.lang.String path, long duration)` 语音转文字
`AbortableFuture<java.lang.String>`	`transVoiceToTextAtScene(java.lang.String voiceUrl, java.lang.String path, long duration, java.lang.String sceneKey)` 语音转文字并指定上传文件的场景
`AbortableFuture<java.lang.String>`	`transVoiceToTextEnableForce(java.lang.String voiceUrl, java.lang.String path, long duration, java.lang.String sceneKey, boolean enableForceUploadFile)` 语音转文字并指定上传文件的场景以及是否要强制重新上传文件
`InvocationFuture<CollectInfo>`	`updateCollect(CollectInfo info, java.lang.String ext)` 更新一个收藏的扩展字段
`InvocationFuture<CollectInfo>`	`updateCollect(long infoId, long createTime, java.lang.String ext)` 更新一个收藏的扩展字段
`void`	`updateIMMessage(IMMessage message)` 更新消息。
`void`	`updateIMMessageStatus(IMMessage message)` 更新消息记录的状态。
`InvocationFuture<java.lang.Long>`	`updateMsgPin(IMMessage msg, java.lang.String ext)` 更新一条消息的PIN
`InvocationFuture<java.lang.Void>`	`updateMySession(java.lang.String sessionId, java.lang.String ext)` 【会话服务】更新某一个会话，主要是设置会话的ext字段，如果会话不存在，则会创建出来，此时会话没有lastMsg
`void`	`updateRecent(RecentContact recent)` 更新一条最近联系人会话的属性。
`void`	`updateRecentAndNotify(RecentContact recent)` 更新一条最近联系人会话的属性，并会触发`MsgServiceObserve.observeRecentContact(Observer, boolean)`的通知。
`void`	`updateRecentByMessage(IMMessage message, boolean needNotify)` 通过消息更新一条最近联系人会话。
`void`	`updateRoamMsgHasMoreTag(IMMessage newTag)` 更新是否有更多漫游消息的标记
`InvocationFuture<StickTopSessionInfo>`	`updateStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)` 更新一个会话在置顶上的扩展字段

- 字段详细资料
  - MSG_CHATTING_ACCOUNT_ALL
```
static final java.lang.String MSG_CHATTING_ACCOUNT_ALL
```
    目前没有与任何人对话，但能看到消息提醒（比如在消息列表界面），不需要在状态栏做消息通知
    
    另请参阅:
    
    setChattingAccount(String, com.netease.nimlib.sdk.msg.constant.SessionTypeEnum), 常量字段值
  - MSG_CHATTING_ACCOUNT_NONE
```
static final java.lang.String MSG_CHATTING_ACCOUNT_NONE
```
    目前没有与任何人对话，需要状态栏消息通知
    
    另请参阅:
    
    setChattingAccount(String, com.netease.nimlib.sdk.msg.constant.SessionTypeEnum)
- 方法详细资料
  - sendMessage
```
InvocationFuture<java.lang.Void> sendMessage(IMMessage msg,
                                             boolean resend)
```
    发送消息。
    如果需要更新发送进度，请调用MsgServiceObserve.observeMsgStatus(com.netease.nimlib.sdk.Observer, boolean)
    
    参数:
    
    msg - 带发送的消息体，由MessageBuilder构造
    
    resend - 如果是发送失败后重发，标记为true，否则填false
    
    返回:
    
    InvocationFuture 可以设置回调函数。消息发送完成后才会调用，如果出错，会有具体的错误代码。
  - replyMessage
```
InvocationFuture<java.lang.Void> replyMessage(IMMessage msg,
                                              IMMessage replyMsg,
                                              boolean resend)
```
    回复消息。
    如果需要更新发送进度，请调用MsgServiceObserve.observeMsgStatus(com.netease.nimlib.sdk.Observer, boolean)
    
    参数:
    
    msg - 带发送的消息体，由MessageBuilder构造
    
    replyMsg - 被回复的消息
    
    resend - 如果是发送失败后重发，标记为true，否则填false
    
    返回:
    
    InvocationFuture 可以设置回调函数。消息发送完成后才会调用，如果出错，会有具体的错误代码。
  - sendFile
```
AbortableFuture<FileAttachment> sendFile(FileAttachment attachment)
```
    上传文件附件
    
    返回:
    
    可以设置回调函数。文件发送完成后才会调用，如果出错，会有具体的错误代码。
  - insertLocalMessage
```
InvocationFuture<java.lang.Void> insertLocalMessage(IMMessage msg,
                                                    java.lang.String fromAccount)
```
    插入消息到本地数据库，且通知更新UI界面，但不发送到服务器端。发送一条可设置他人为发送方的本地消息给自己。
    该接口将消息保存到数据库后，会通知到UI，此时会触发MsgServiceObserve.observeReceiveMessage(Observer, boolean)通知。
    
    参数:
    
    msg - 待保存的消息对象
    
    fromAccount - 发送者ID
    
    返回:
    
    InvocationFuture 可以设置回调函数。在消息存入数据库后,就会回调。
  - saveMessageToLocal
```
InvocationFuture<java.lang.Void> saveMessageToLocal(IMMessage msg,
                                                    boolean notify)
```
    保存消息到本地数据库，但不发送到服务器端。用于第三方APP保存本地提醒一类的消息。
    该接口将消息保存到数据库后，如果需要通知到UI，可将notify设置为true，此时会触发MsgServiceObserve.observeReceiveMessage(Observer, boolean)通知。
    
    参数:
    
    msg - 待保存的消息对象
    
    notify - 是否要通知UI更新界面
    
    返回:
    
    InvocationFuture 可以设置回调函数。在消息存入数据库后,就会回调。
  - saveMessageToLocalEx
```
InvocationFuture<java.lang.Void> saveMessageToLocalEx(IMMessage msg,
                                                      boolean notify,
                                                      long time)
```
    保存消息到本地数据库，但不发送到服务器端。可设置保存消息的时间用于第三方APP保存本地提醒一类的消息。该接口将消息保存到数据库后，如果需要通知到UI，可将notify设置为true，此时会触发MsgServiceObserve.observeReceiveMessage(Observer, boolean)通知。
    
    参数:
    
    msg - 待保存的消息对象
    
    notify - 是否要通知UI更新界面
    
    time - 保存消息的时间, 使用NIMMessage.getTime()
    
    返回:
    
    InvocationFuture 可以设置回调函数。在消息存入数据库后,就会回调。
  - downloadAttachment
```
AbortableFuture<java.lang.Void> downloadAttachment(IMMessage msg,
                                                   boolean thumb)
```
    正常情况收到消息后附件会自动下载。如果下载失败，可调用该接口重新下载
    
    参数:
    
    msg - 附件所在的消息体
    
    thumb - 下载缩略图还是原文件。为true时，仅下载缩略图。
    该参数仅对图片和视频类消息有效
    
    返回:
    
    AbortableFuture 调用跟踪。可设置回调函数，可中止下载操作
  - queryMessageListByUuidBlock
```
java.util.List<IMMessage> queryMessageListByUuidBlock(java.util.List<java.lang.String> uuids)
```
    通过uuid批量获取IMMessage(同步版本)
    
    参数:
    
    uuids - 消息的uuid列表
    
    返回:
  - queryMessageListByUuid
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListByUuid(java.util.List<java.lang.String> uuids)
```
    通过uuid批量获取IMMessage
    
    参数:
    
    uuids - 消息的uuid列表
    
    返回:
  - queryMessageListByServerIdBlock
```
java.util.List<IMMessage> queryMessageListByServerIdBlock(java.util.List<java.lang.String> serverIds)
```
    通过 Server ID 批量获取IMMessage(同步版本) 注意：一个ServerId可能对应多条消息
    
    参数:
    
    serverIds - 消息的Server ID列表
    
    返回:
    
    ServerId在参数列表中的消息组成的列表
  - queryMessageListByType
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListByType(MsgTypeEnum msgTypeEnum,
                                                                   IMMessage anchor,
                                                                   int limit)
```
    通过消息类型从本地消息数据库中查询消息历史。查询范围由msgTypeEnum参数和anchor的sessionId决定该接口查询方向为从后往前。以锚点anchor作为起始点（不包含锚点），往前查询最多limit条消息。
    
    参数:
    
    msgTypeEnum - 消息类型
    
    anchor - 搜索的消息锚点
    
    limit - 搜索结果的条数限制
    
    返回:
  - queryMessageListByType
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListByType(MsgTypeEnum msgTypeEnum,
                                                                   java.lang.Long maxTime,
                                                                   int limit)
```
    通过消息类型查询所有消息记录，
    
    参数:
    
    maxTime - 查询开始时间, 开区间，往后或者limit条，如果maxTime为空表示查询所有记录
    
    msgTypeEnum - 消息类型
    
    limit - 每次获取条数， limit<=0 返回参数错误
    
    返回:
  - queryMessageListBySubtypeBlock
```
java.util.List<IMMessage> queryMessageListBySubtypeBlock(MsgTypeEnum msgTypeEnum,
                                                         IMMessage anchor,
                                                         int limit,
                                                         int subtype)
```
    通过消息子类型查询本地消息记录（同步版本）
    
    参数:
    
    msgTypeEnum - 消息类型
    
    anchor - 搜索的消息锚点
    
    limit - 搜索结果的条数限制
    
    subtype - 子类型
    
    返回:
    
    子类型和subtype一致的消息的列表
  - queryMessageListBySubtype
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListBySubtype(MsgTypeEnum msgTypeEnum,
                                                                      IMMessage anchor,
                                                                      int limit,
                                                                      int subtype)
```
    通过消息子类型查询本地消息记录（异步版本）
    
    参数:
    
    subtype - 子类型
    
    anchor - 搜索的消息锚点
    
    limit - 搜索结果的条数限制
    
    返回:
    
    InvocationFuture
  - queryMessageList
```
InvocationFuture<java.util.List<IMMessage>> queryMessageList(java.lang.String account,
                                                             SessionTypeEnum sessionType,
                                                             long offset,
                                                             int limit)
```
    已过时。请使用 queryMessageListEx(IMMessage, QueryDirectionEnum, int, boolean) 来替代。
    
    从本地消息数据库中查询消息历史。
    按照消息记录时间先后倒序查询，查询条件为 "ORDER BY time desc limit ${limit} offset ${offset}"。
    注意：返回结果的消息历史列表排列顺序也为倒序：即时间大的消息在前，时间小的消息在后。
    
    参数:
    
    account - 待查询的聊天对象帐号(个人帐号/群组ID)
    
    sessionType - 聊天对象类型(单人聊天/群组)
    
    offset - 查询偏移量
    
    limit - 查询列表限长
    
    返回:
    
    InvocationFuture
  - queryMessageListEx
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListEx(IMMessage anchor,
                                                               QueryDirectionEnum direction,
                                                               int limit,
                                                               boolean asc)
```
    根据锚点和方向从本地消息数据库中查询消息历史。
    根据提供的方向(direct)，查询比anchor更老（QUERY_OLD）或更新（QUERY_NEW）的最靠近anchor的limit条数据。
    调用者可使用asc参数指定结果排序规则，结果使用time作为排序字段。
    注意：查询结果不包含锚点。
    
    参数:
    
    anchor - 查询锚点
    
    direction - 查询方向
    
    limit - 查询结果的条数限制
    
    asc - 查询结果的排序规则，如果为true，结果按照时间升序排列，如果为false，按照时间降序排列
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryMessageListExBlock
```
java.util.List<IMMessage> queryMessageListExBlock(IMMessage anchor,
                                                  QueryDirectionEnum direction,
                                                  int limit,
                                                  boolean asc)
```
    根据锚点和方向从本地消息数据库中查询消息历史。（同步函数）
    根据提供的方向(direct)，查询比anchor更老（QUERY_OLD）或更新（QUERY_NEW）的最靠近anchor的limit条数据。
    调用者可使用asc参数指定结果排序规则，结果使用time作为排序字段。
    注意：查询结果不包含锚点。
    
    参数:
    
    anchor - 查询锚点
    
    direction - 查询方向
    
    limit - 查询结果的条数限制
    
    asc - 查询结果的排序规则，如果为true，结果按照时间升序排列，如果为false，按照时间降序排列
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryMessageListExTime
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListExTime(IMMessage anchor,
                                                                   long toTime,
                                                                   QueryDirectionEnum direction,
                                                                   int limit)
```
    根据起始、截止时间点以及查询方向从本地消息数据库中查询消息历史。
    根据提供的方向 (direction)，以 anchor 为起始点，往前或往后查询由 anchor 到 toTime 之间靠近 anchor 的 limit 条消息。
    查询范围由 toTime 和 limit 共同决定，以先到为准。如果到 toTime 之间消息大于 limit 条，返回 limit 条记录，如果小于 limit 条，返回实际条数。
    查询结果排序规则：direction 为 QUERY_OLD 时按时间降序排列，direction 为 QUERY_NEW 时按照时间升序排列。
    注意：查询结果不包含锚点。
    
    参数:
    
    anchor - 查询锚点
    
    toTime - 查询截止时间，若方向为 QUERY_OLD，toTime 应小于 anchor.getTime()。方向为 QUERY_NEW，toTime 应大于 anchor.getTime()
    
    direction - 查询方向
    
    limit - 查询结果的条数限制
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryMessageListByTypes
```
@Deprecated
InvocationFuture<java.util.List<IMMessage>> queryMessageListByTypes(java.util.List<MsgTypeEnum> types,
                                                                                IMMessage anchor,
                                                                                long toTime,
                                                                                QueryDirectionEnum direction,
                                                                                int limit,
                                                                                boolean asc)
```
    已过时。
    
    根据起始、截止时间点以及查询方向从本地消息数据库中查询指定消息类型的消息历史。
    根据提供的方向 (direction)，以 anchor 为起始点，往前或往后查询由 anchor 到 toTime 之间靠近 anchor 的 limit 条消息。
    查询范围由 toTime 和 limit 共同决定，以先到为准。如果到 toTime 之间消息大于 limit 条，返回 limit 条记录，如果小于 limit 条，返回实际条数。
    查询结果排序规则：如果asc为true，结果按照时间升序排列，如果为false，按照时间降序排列
    注意：查询结果不包含锚点。
    
    参数:
    
    types - 查询的消息类型集合, 传入null表示所有消息类型，同 queryMessageListExTime(com.netease.nimlib.sdk.msg.model.IMMessage, long, com.netease.nimlib.sdk.msg.model.QueryDirectionEnum, int) 结果
    
    anchor - 查询锚点
    
    toTime - 查询截止时间，若方向为 QUERY_OLD，toTime 应小于 anchor.getTime()。方向为 QUERY_NEW，toTime 应大于 anchor.getTime(), 填0表示没有时间限制，以 limit限制为主
    
    direction - 查询方向
    
    limit - 查询结果的条数限制
    
    asc - 查询结果的排序规则，如果为true，结果按照时间升序排列，如果为false，按照时间降序排列
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryMessageListByTypesV2
```
InvocationFuture<java.util.List<IMMessage>> queryMessageListByTypesV2(java.util.List<MsgTypeEnum> types,
                                                                      IMMessage anchor,
                                                                      long toTime,
                                                                      QueryDirectionEnum direction,
                                                                      int limit,
                                                                      boolean asc)
```
    根据起始、截止时间点以及查询方向从本地消息数据库中查询指定消息类型的消息历史。
    根据提供的方向 (direction)，以 anchor 为起始点，往前或往后查询由 anchor 到 toTime 之间靠近 anchor 的 limit 条消息。
    查询范围由 toTime 和 limit 共同决定，以先到为准。如果到 toTime 之间消息大于 limit 条，返回 limit 条记录，如果小于 limit 条，返回实际条数。
    查询结果排序规则：如果asc为true，结果按照时间升序排列，如果为false，按照时间降序排列
    注意：查询结果不包含锚点。
    
    参数:
    
    types - 查询的消息类型集合, 传入null表示所有消息类型，同 queryMessageListExTime(com.netease.nimlib.sdk.msg.model.IMMessage, long, com.netease.nimlib.sdk.msg.model.QueryDirectionEnum, int) 结果
    
    anchor - 查询锚点,锚点消息类型可不在查询的消息类型集合范围内
    
    toTime - 查询截止时间，若方向为 QUERY_OLD，toTime 应小于 anchor.getTime()。方向为 QUERY_NEW，toTime 应大于 anchor.getTime(), 填0表示没有时间限制，以 limit限制为主
    
    direction - 查询方向
    
    limit - 查询结果的条数限制
    
    asc - 查询结果的排序规则，如果为true，结果按照时间升序排列，如果为false，按照时间降序排列
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryRoamMsgHasMoreTime
```
InvocationFuture<java.lang.Long> queryRoamMsgHasMoreTime(java.lang.String sessionId,
                                                         SessionTypeEnum sessionType)
```
    获取是否有更多漫游消息标记的时间戳，如果没有，回调0L
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryRoamMsgHasMoreTimeBlock
```
long queryRoamMsgHasMoreTimeBlock(java.lang.String sessionId,
                                  SessionTypeEnum sessionType)
```
    获取是否有更多漫游消息标记的时间戳，如果没有，回调0L（同步接口）
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryRoamMsgHasMoreTagServerId
```
InvocationFuture<java.lang.Long> queryRoamMsgHasMoreTagServerId(java.lang.String sessionId,
                                                                SessionTypeEnum sessionType)
```
    获取是否有更多漫游消息标记的serverid，如果没有，回调0L
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - queryRoamMsgHasMoreTagServerIdBlock
```
long queryRoamMsgHasMoreTagServerIdBlock(java.lang.String sessionId,
                                         SessionTypeEnum sessionType)
```
    获取是否有更多漫游消息标记的serverid，如果没有，回调0L（同步接口）
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    调用跟踪，可设置回调函数，接收查询结果
  - pullHistoryById
```
InvocationFuture<java.util.List<IMMessage>> pullHistoryById(java.util.List<MessageKey> msgKeyList,
                                                            boolean persist)
```
    根据消息ID等信息从服务器批量查询历史消息
    
    参数:
    
    msgKeyList - 查询消息的关键字
    
    persist - 是否持久化
    
    返回:
    
    InvocationFuture
  - queryLastMessage
```
IMMessage queryLastMessage(java.lang.String account,
                           SessionTypeEnum sessionType)
```
    查询同指定用户的最近一条消息
    
    参数:
    
    account - 账号
    
    sessionType - 会话类型
    
    返回:
    
    message
  - pullMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistory(IMMessage anchor,
                                                               int limit,
                                                               boolean persist)
```
    从服务器拉取消息历史记录。该接口查询方向为从后往前。以锚点anchor作为起始点（不包含锚点），往前查询最多limit条消息。
    当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 查询锚点。
    首次查询，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    limit - 本次查询的消息条数上限(最多100条)
    
    persist - 通过该接口获取的漫游消息记录，是否保存到本地消息数据库。
    
    返回:
    
    InvocationFuture
  - pullMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistory(IMMessage anchor,
                                                               int limit,
                                                               boolean persist,
                                                               boolean persistClear)
```
    从服务器拉取消息历史记录。该接口查询方向为从后往前。以锚点anchor作为起始点（不包含锚点），往前查询最多limit条消息。
    当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 查询锚点。
    首次查询，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    limit - 本次查询的消息条数上限(最多100条)
    
    persist - 通过该接口获取的漫游消息记录，是否保存到本地消息数据库。
    
    persistClear - 是否保存清除记录之前的消息到本地数据库，在persist==true时生效
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryEx
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryEx(IMMessage anchor,
                                                                 long toTime,
                                                                 int limit,
                                                                 QueryDirectionEnum direction,
                                                                 boolean persist)
```
    从服务器拉取消息历史记录。以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    persist - 通过该接口获取的漫游消息记录，是否保存到本地消息数据库。
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryExType
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryExType(IMMessage anchor,
                                                                     long toTime,
                                                                     int limit,
                                                                     QueryDirectionEnum direction,
                                                                     MsgTypeEnum[] msgTypes)
```
    从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
    以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小，默认不保存到数据库
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    msgTypes - 消息类型，数组。消息类型仅支持 0:文本，1:图片，2:语音，3:视频，4:地理位置，5:通知，6:文件，10:提示，100:自定义，其它为非法参数
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryExType
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryExType(IMMessage anchor,
                                                                     long toTime,
                                                                     int limit,
                                                                     QueryDirectionEnum direction,
                                                                     MsgTypeEnum[] msgTypes,
                                                                     boolean persist)
```
    从服务器拉取消息历史记录，可以指定查询的消息类型，结果是否保存到本地消息数据库。
    以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    msgTypes - 消息类型，数组。消息类型仅支持 0:文本，1:图片，2:语音，3:视频，4:地理位置，5:通知，6:文件，10:提示，100:自定义，其它为非法参数
    
    persist - 通过该接口获取的漫游消息记录，是否保存到本地消息数据库。
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryExType
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryExType(IMMessage anchor,
                                                                     long toTime,
                                                                     int limit,
                                                                     QueryDirectionEnum direction,
                                                                     MsgTypeEnum[] msgTypes,
                                                                     boolean persist,
                                                                     boolean persistClear)
```
    从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
    以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    msgTypes - 消息类型，数组。消息类型仅支持 0:文本，1:图片，2:语音，3:视频，4:地理位置，5:通知，6:文件，10:提示，100:自定义，其它为非法参数
    
    persist - 通过该接口获取的漫游消息记录，要不要保存到本地消息数据库。
    
    persistClear - 是否保存被清除的消息到本地数据库，在persist==true时生效
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryExType
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryExType(IMMessage anchor,
                                                                     long toTime,
                                                                     int limit,
                                                                     QueryDirectionEnum direction,
                                                                     MsgTypeEnum[] msgTypes,
                                                                     boolean persist,
                                                                     boolean persistClear,
                                                                     IMMessageFilter customFilter)
```
    从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
    以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    msgTypes - 消息类型，数组。消息类型仅支持 0:文本，1:图片，2:语音，3:视频，4:地理位置，5:通知，6:文件，10:提示，100:自定义，其它为非法参数
    
    persist - 通过该接口获取的漫游消息记录，要不要保存到本地消息数据库。
    
    persistClear - 是否保存被清除的消息到本地数据库，在persist==true时生效
    
    customFilter - 过滤器回调，如果返回true则被忽略，即视为没有拉到这条消息
    
    返回:
    
    InvocationFuture
  - pullMessageHistoryExType
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryExType(IMMessage anchor,
                                                                     long toTime,
                                                                     int limit,
                                                                     QueryDirectionEnum direction,
                                                                     MsgTypeEnum[] msgTypes,
                                                                     boolean persist,
                                                                     boolean persistClear,
                                                                     IMMessageFilter customFilter,
                                                                     boolean updateUnread)
```
    从服务器拉取消息历史记录，可以指定查询的消息类型，结果不存本地消息数据库。
    以锚点anchor作为起始点（不包含锚点），根据direction参数，往前或往后查询由锚点到toTime之间的最多limit条消息。
    查询范围由toTime和limit共同决定，以先到为准。如果到toTime之间消息大于limit条，返回limit条记录，如果小于limit条，返回实际条数。当已经查询到头时，返回的结果列表的size可能会比limit小
    
    参数:
    
    anchor - 起始时间点的消息，不能为null。
    设置自定义锚点时，使用 MessageBuilder.createEmptyMessage(String, SessionTypeEnum, long) 创建一个空对象即可
    
    toTime - 结束时间点单位毫秒
    
    limit - 本次查询的消息条数上限(最多100条)
    
    direction - 查询方向，QUERY_OLD按结束时间点逆序查询，逆序排列；QUERY_NEW按起始时间点正序起查，正序排列
    
    msgTypes - 消息类型，数组。消息类型仅支持 0:文本，1:图片，2:语音，3:视频，4:地理位置，5:通知，6:文件，10:提示，100:自定义，其它为非法参数
    
    persist - 通过该接口获取的漫游消息记录，要不要保存到本地消息数据库。
    
    persistClear - 是否保存被清除的消息到本地数据库，在persist==true时生效
    
    customFilter - 过滤器回调，如果返回true则被忽略，即视为没有拉到这条消息
    
    updateUnread - 是否计算未读数
    
    返回:
    
    InvocationFuture
  - pullMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistory(MsgFullKeywordSearchConfig config)
```
    云端历史消息全文检索
    
    参数:
    
    config - 配置
  - pullMessageHistoryOrderByTime
```
InvocationFuture<java.util.List<IMMessage>> pullMessageHistoryOrderByTime(MsgTimingFullKeywordSearchConfig config)
```
    云端历史消息全文检索(按时间排序，不按会话分组)
    
    参数:
    
    config - 检索配置
  - getMessagesDynamically
```
InvocationFuture<GetMessagesDynamicallyResult> getMessagesDynamically(GetMessagesDynamicallyParam param)
```
    动态途径获取消息，默认从本地获取，动态能力需要开通功能，并在同步完成后生效
    
    参数:
    
    param - 参数
    
    返回:
    
    InvocationFuture
  - searchMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> searchMessageHistory(java.lang.String keyword,
                                                                 java.util.List<java.lang.String> fromAccounts,
                                                                 IMMessage anchor,
                                                                 int limit)
```
    从本地消息数据库搜索消息历史。查询范围由anchor的sessionId和sessionType决定。
    以锚点anchor作为起始点开始查询，返回最多limit条匹配key的记录。
    该接口目前仅搜索文本类型的消息，匹配规则为文本内容包含keyword，仅支持精确匹配，不支持模糊匹配和拼音匹配。
    由于sdk并不存储用户数据，因此keyword不会匹配用户资料。如果调用者希望查询指定用户的说话记录，可提供fromAccounts参数。
    如果提供的fromAccounts参数不为空，那么anchor对应的会话（sessionId和sessionType）的消息记录中，凡是消息说话者在fromAccounts列表中的记录，也会被当做匹配结果，加入搜索结果中。注意：搜索结果不包含anchor
    
    参数:
    
    keyword - 文本消息的搜索关键字
    
    fromAccounts - 消息说话者帐号列表，如果消息说话在该列表中，那么无需匹配keyword，对应的消息记录会直接加入搜索结果集中。
    
    anchor - 搜索的消息锚点
    
    limit - 搜索结果的条数限制
    
    返回:
    
    InvocationFuture
  - searchMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> searchMessageHistory(java.lang.String keyword,
                                                                 java.util.List<java.lang.String> fromAccounts,
                                                                 IMMessage anchor,
                                                                 QueryDirectionEnum direction,
                                                                 int limit)
```
    从本地消息数据库搜索消息历史。查询范围由anchor的sessionId和sessionType决定。
    该接口查询方向为从后往前。以锚点anchor作为起始点开始查询，返回最多limit条匹配key的记录。
    该接口目前仅搜索文本类型的消息，匹配规则为文本内容包含keyword，仅支持精确匹配，不支持模糊匹配和拼音匹配。
    由于sdk并不存储用户数据，因此keyword不会匹配用户资料。如果调用者希望查询指定用户的说话记录，可提供fromAccounts参数。
    如果提供的fromAccounts参数不为空，那么anchor对应的会话（sessionId和sessionType）的消息记录中，凡是消息说话者在fromAccounts列表中的记录，也会被当做匹配结果，加入搜索结果中。注意：搜索结果不包含anchor
    
    参数:
    
    keyword - 文本消息的搜索关键字
    
    fromAccounts - 消息说话者帐号列表，如果消息说话在该列表中，那么无需匹配keyword，对应的消息记录会直接加入搜索结果集中。
    
    anchor - 搜索的消息锚点
    
    direction - 查询方向
    
    limit - 搜索结果的条数限制
    
    返回:
    
    InvocationFuture
  - searchAllMessageHistory
```
InvocationFuture<java.util.List<IMMessage>> searchAllMessageHistory(java.lang.String keyword,
                                                                    java.util.List<java.lang.String> fromAccounts,
                                                                    long time,
                                                                    int limit)
```
    从本地消息数据库搜索消息历史。该接口查询方向以某个时间点为基准从后往前，返回最多limit条匹配key的记录。
    该接口目前仅搜索文本类型的消息，匹配规则为文本内容包含keyword，仅支持精确匹配，不支持模糊匹配和拼音匹配。
    由于sdk并不存储用户数据，因此keyword不会匹配用户资料。如果调用者希望查询指定用户的说话记录，可提供fromAccounts参数。
    如果提供的fromAccounts参数不为空，那么凡是消息说话者在fromAccounts列表中的记录，也会被当做匹配结果，加入搜索结果中。
    
    参数:
    
    keyword - 文本消息的搜索关键字
    
    fromAccounts - 消息说话者帐号列表，如果消息说话在该列表中，那么无需匹配keyword，对应的消息记录会直接加入搜索结果集中。
    
    time - 查询范围时间点，比time小（从后往前查）
    
    limit - 搜索结果的条数限制
    
    返回:
    
    InvocationFuture
  - searchMessage
```
InvocationFuture<java.util.List<IMMessage>> searchMessage(SessionTypeEnum sessionType,
                                                          java.lang.String sessionId,
                                                          MsgSearchOption option)
```
    从本地消息数据库搜索消息历史。搜索将返回：时间在 (startTime,endTime) 之间，消息类型为指定类型，且匹配搜索内容或消息发起者列表的一定数量的消息。
    
    参数:
    
    sessionType - 会话类型
    
    sessionId - 聊天对象ID
    
    option - 搜索选项
    
    返回:
    
    InvocationFuture
  - searchAllMessage
```
InvocationFuture<java.util.List<IMMessage>> searchAllMessage(MsgSearchOption option)
```
    从本地消息数据库全局搜索消息历史。搜索将返回：时间在 (startTime,endTime) 之间，消息类型为指定类型，且匹配搜索内容或消息发起者列表的一定数量的消息。
    
    参数:
    
    option - 搜索选项
    
    返回:
    
    InvocationFuture
  - searchAllSession
```
InvocationFuture<java.util.List<MsgIndexRecord>> searchAllSession(java.lang.String query,
                                                                  int limit)
```
    检索所有会话，返回每个会话与检索串匹配的消息数及最近一条匹配的消息记录。（异步函数）
    
    参数:
    
    query - 待检索的字符串
    
    limit - 最多返回多少条记录
    
    返回:
    
    InvocationFuture 可以设置回调函数，回调时返回聊天消息全文检索结果集
  - searchAllSessionBlock
```
java.util.List<MsgIndexRecord> searchAllSessionBlock(java.lang.String query,
                                                     int limit)
```
    检索所有会话，返回每个会话与检索串匹配的消息数及最近一条匹配的消息记录。（同步函數）
    
    参数:
    
    query - 待检索的字符串
    
    limit - 最多返回多少条记录
    
    返回:
    
    聊天消息全文检索结果集
  - searchSession
```
InvocationFuture<java.util.List<MsgIndexRecord>> searchSession(java.lang.String query,
                                                               SessionTypeEnum sessionType,
                                                               java.lang.String sessionId)
```
    检索指定的会话，返回该会话中与检索串匹配的所有消息记录。（异步函数）
    
    参数:
    
    query - 待检索的字符串
    
    sessionType - 待检索的会话类型（个人/群组）
    
    sessionId - 待检索的会话ID
    
    返回:
    
    聊天消息全文检索结果集
  - searchSessionBlock
```
java.util.List<MsgIndexRecord> searchSessionBlock(java.lang.String query,
                                                  SessionTypeEnum sessionType,
                                                  java.lang.String sessionId)
```
    检索指定的会话，返回该会话中与检索串匹配的所有消息记录。（同步函数）
    
    参数:
    
    query - 待检索的字符串
    
    sessionType - 待检索的会话类型（个人/群组）
    
    sessionId - 待检索的会话ID
    
    返回:
    
    InvocationFuture 可以设置回调函数，回调时返回聊天消息全文检索结果集
  - deleteChattingHistory
```
void deleteChattingHistory(IMMessage message)
```
    删除一条消息记录，并在数据库记录此操作从云端拉取消息时，如果本地有删除该消息的操作记录，则该消息不会入库删除标记会被清除标记覆盖
    
    参数:
    
    message - 待删除的消息记录
  - deleteChattingHistory
```
void deleteChattingHistory(IMMessage message,
                           boolean ignore)
```
    删除一条消息记录
    
    参数:
    
    message - 待删除的消息记录
    
    ignore - true: 本地不记录清除操作; false: 本地记录清除操作从云端拉取消息时，如果本地有删除该消息的操作记录，则该消息不会入库删除标记会被清除标记覆盖
  - deleteChattingHistory
```
void deleteChattingHistory(java.util.List<IMMessage> msgList,
                           boolean ignore)
```
    删除多条消息记录
    
    参数:
    
    msgList - 待删除的消息记录
    
    ignore - true: 本地不记录清除操作; false: 本地记录清除操作从云端拉取消息时，如果本地有删除该消息的操作记录，则该消息不会入库删除标记会被清除标记覆盖
  - clearChattingHistory
```
void clearChattingHistory(java.lang.String account,
                          SessionTypeEnum sessionType)
```
    清除与指定用户的所有消息记录，且不在数据库记录此次操作
    
    参数:
    
    account - 会话ID
    
    sessionType - 聊天类型
  - clearChattingHistory
```
void clearChattingHistory(java.lang.String account,
                          SessionTypeEnum sessionType,
                          boolean ignore)
```
    清除与指定用户的所有本地消息记录
    
    参数:
    
    account - 会话ID
    
    sessionType - 聊天类型
    
    ignore - true: 本地不记录清除操作; false: 本地记录清除操作，清除记录的作用参见pullMessageHistory(IMMessage, int, boolean, boolean)
  - clearMsgDatabase
```
InvocationFuture<java.lang.Void> clearMsgDatabase(boolean clearRecent)
```
    清空消息数据库的所有消息记录。
    可选择是否要同时清空最近联系人列表数据库。
    若最近联系人列表也被清空，会触发MsgServiceObserve.observeRecentContactDeleted(Observer, boolean)通知
    
    参数:
    
    clearRecent - 若为true，将同时清空最近联系人列表数据
  - deleteMsgSelf
```
InvocationFuture<java.lang.Long> deleteMsgSelf(IMMessage msg,
                                               java.lang.String ext)
```
    单向删除一条消息
    
    参数:
    
    msg - 被单向删除的消息
    
    ext - 扩展字段
  - deleteMsgSelf
```
InvocationFuture<java.lang.Long> deleteMsgSelf(java.util.List<IMMessage> msgList,
                                               java.lang.String ext)
```
    单向删除多条消息
    
    参数:
    
    msgList - 被单向删除的消息
    
    ext - 扩展字段
  - everBeenDeleted
```
boolean everBeenDeleted(IMMessage message)
```
    消息是否曾被从本地删除
    
    参数:
    
    message - 待查询消息
    
    返回:
    
    是否曾被本地删除
  - setChattingAccount
```
void setChattingAccount(java.lang.String account,
                        SessionTypeEnum sessionType)
```
    设置当前正在聊天的对象。设置后会影响内建的消息提醒。如果有新消息到达，且消息来源是正在聊天的对象，将不会有消息提醒。
    调用该接口还会附带调用clearUnreadCount(String, SessionTypeEnum),将正在聊天对象的未读数清零。
    
    参数:
    
    account, - 聊天对象帐号，或者以下两个值：
    MSG_CHATTING_ACCOUNT_ALL
    MSG_CHATTING_ACCOUNT_NONE
    
    sessionType - 会话类型。如果account不是具体的对象，该参数将被忽略
  - getTotalUnreadCount
```
int getTotalUnreadCount()
```
    获取未读数总数
  - getTotalUnreadCount
```
int getTotalUnreadCount(boolean notify)
```
    获取未读数总数
    
    参数:
    
    notify - true表示只查询排除免打扰之外的消息总未读数，false表示只查询免打扰的消息总未读数
    
    返回:
    
    未读数总数
  - getUnreadCountBySessionType
```
int getUnreadCountBySessionType(SessionTypeEnum sessionType)
```
    获取指定会话类型的总未读数
  - queryUnreadMessageList
```
InvocationFuture<java.util.List<IMMessage>> queryUnreadMessageList(java.lang.String sessionId,
                                                                   SessionTypeEnum sessionType)
```
    根据会话ID和会话类型查找未读消息列表
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    未读消息列表
  - queryUnreadMessageListBlock
```
java.util.List<IMMessage> queryUnreadMessageListBlock(java.lang.String sessionId,
                                                      SessionTypeEnum sessionType)
```
    根据会话ID和会话类型查找未读消息列表（同步版本）
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
    
    返回:
    
    未读消息列表
  - clearUnreadCount
```
InvocationFuture<java.lang.Void> clearUnreadCount(java.lang.String account,
                                                  SessionTypeEnum sessionType)
```
    将指定最近联系人的未读数清零(标记已读)。
    调用该接口后，会触发MsgServiceObserve.observeRecentContact(Observer, boolean) 通知
    
    参数:
    
    account - 聊天对象帐号
    
    sessionType - 会话类型
  - clearUnreadCount
```
InvocationFuture<java.util.List<SessionAckInfo>> clearUnreadCount(java.util.List<<any>> sessionKeyList)
```
    将指定最近联系人的未读数清零(标记已读)。
    调用该接口后，会触发MsgServiceObserve.observeRecentContact(Observer, boolean) 通知
    
    参数:
    
    sessionKeyList - 聊天对象帐号列表，Pair的第一项为会话ID，第二项为会话类型会话类型支持传入SessionTypeEnum.P2P和SessionTypeEnum.Team
  - clearUnreadCount
```
InvocationFuture<java.util.List<SessionAckInfo>> clearUnreadCount(SessionTypeEnum sessionType)
```
    将指定会话类型的未读数清零(标记已读)。
    调用该接口后，会触发MsgServiceObserve.observeRecentContact(Observer, boolean) 通知
    
    参数:
    
    sessionType - 会话类型，支持传入SessionTypeEnum.P2P和SessionTypeEnum.Team
  - clearAllUnreadCount
```
void clearAllUnreadCount()
```
    将所有联系人的未读数清零(标记已读) 调用该接口后，会触发MsgServiceObserve.observeRecentContact(Observer, boolean) 通知
  - sendMessageReceipt
```
InvocationFuture<java.lang.Void> sendMessageReceipt(java.lang.String sessionId,
                                                    IMMessage message)
```
    发送P2P消息已读回执
    
    参数:
    
    sessionId - 会话ID（聊天对象账号）
    
    message - P2P已读的消息
  - updateIMMessageStatus
```
void updateIMMessageStatus(IMMessage message)
```
    更新消息记录的状态。可更新：
    消息状态 NIMMessage.getStatus() 不为 null 时更新
    附件状态 NIMMessage.getAttachStatus() 不为 null 时更新
    附件内容 NIMMessage.getAttachment() 不为 null 时更新
    
    参数:
    
    message - 待更新的消息记录
  - updateIMMessage
```
void updateIMMessage(IMMessage message)
```
    更新消息。目前只能更新本地扩展字段LocalExtension
    
    参数:
    
    message - 待更新的消息记录
  - registerCustomAttachmentParser
```
void registerCustomAttachmentParser(MsgAttachmentParser customParser)
```
    如果第三方app需要自定义的附件消息类型，再次注册自己的附件解析器。
    客户自定义的消息类型为MsgTypeEnum.custom
    自定义附件类型须继承自MsgAttachment。
    
    参数:
    
    customParser - 附件解析器
  - sendCustomNotification
```
InvocationFuture<java.lang.Void> sendCustomNotification(CustomNotification notification)
```
    发送一条指令消息。
    由于SDK仅负责透传该消息，因此不会记录指令消息状态，但可以设置回调函数监听发送结果。
    
    参数:
    
    notification - 指令消息
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - queryRecentContacts
```
InvocationFuture<java.util.List<RecentContact>> queryRecentContacts()
```
    查询最近联系人会话列表数据
    
    返回:
    
    InvocationFuture
  - queryRecentContactsBlock
```
java.util.List<RecentContact> queryRecentContactsBlock()
```
    查询最近联系人会话列表数据(同步版本)
  - queryRecentContacts
```
InvocationFuture<java.util.List<RecentContact>> queryRecentContacts(int limit)
```
    查询最近联系人会话列表数据, 可以设置limit，防止本地会话过多时，导致第一次加载慢
    
    参数:
    
    limit - 获取本地会话的数量，最大100，超过100修正到100
    
    返回:
    
    InvocationFuture
  - queryRecentContacts
```
InvocationFuture<java.util.List<RecentContact>> queryRecentContacts(RecentContact anchor,
                                                                    QueryDirectionEnum direction,
                                                                    int limit)
```
    查询最近联系人会话列表数据，可按时间逆序或者正序查询指定数量的最新会话列表数据
    
    参数:
    
    anchor - 查询最近联系人会话列表的锚点如果首次查询传null即可; 如果首次查询，当查询方向direction为QUERY_NEW时，则时间按0开始查询；如果首次查询，当查询方向direction为QUERY_OLD时，则时间按当前系统时间开始查询；如果想查询下一页数据，传入上一页数据的最后一个RecentContact即可
    
    direction - 查询方向 QUERY_OLD查询在时间在anchor之前的数据，逆序排列； QUERY_NEW查询时间在anchor之后的数据，正序排列
    
    limit - 获取本地会话的数量最大100，超过100修正到100
    
    返回:
    
    InvocationFuture
  - queryRecentContactsBlock
```
java.util.List<RecentContact> queryRecentContactsBlock(int limit)
```
    查询最近联系人会话列表数据(同步版本)，可以设置limit，防止本地会话过多时，导致第一次加载慢
    
    参数:
    
    limit - 获取本地会话的数量，最大100，超过100修正到100
  - queryRecentContactsBlock
```
java.util.List<RecentContact> queryRecentContactsBlock(RecentContact anchor,
                                                       QueryDirectionEnum direction,
                                                       int limit)
```
    查询最近联系人会话列表数据(同步版本)，可按时间逆序或者正序查询指定数量的最新会话列表数据
    
    参数:
    
    anchor - 查询最近联系人会话列表的锚点如果首次查询传null即可; 如果首次查询，当查询方向direction为QUERY_NEW时，则时间按0开始查询；如果首次查询，当查询方向direction为QUERY_OLD时，则时间按当前系统时间开始查询；如果想查询下一页数据，传入上一页数据的最后一个RecentContact即可
    
    direction - 查询方向 QUERY_OLD查询在时间在queryTime之前的数据，逆序排列； QUERY_NEW查询时间在queryTime之后的数据，正序排列
    
    limit - 获取本地会话的数量最大100，超过100修正到100
    
    返回:
    
    最近联系人会话列表
  - queryRecentContacts
```
InvocationFuture<java.util.List<RecentContact>> queryRecentContacts(MsgTypeEnum filterMsgType)
```
    查询联系人最近会话列表数据, 最近一条不等于过滤消息类型， eg：需要过滤MsgTypeEnum.notification, 则传入改type note ：该方法返回未读为全量消息未读
    
    参数:
    
    filterMsgType - 过滤消息类型
    
    返回:
    
    InvocationFuture
  - queryRecentContactsBlock
```
java.util.List<RecentContact> queryRecentContactsBlock(MsgTypeEnum filterMsgType)
```
    查询联系人最近会话列表数据(同步版本)，最近一条不等于过滤消息类型，该方法可能会执行较长时间，建议使用异步版本, note ：该方法返回未读为全量消息未读
    
    参数:
    
    filterMsgType - 过滤消息类型
  - queryRecentContacts
```
InvocationFuture<java.util.List<RecentContact>> queryRecentContacts(java.util.Set<MsgTypeEnum> filterMsgTypeSet)
```
    查询联系人最近会话列表数据, 最近一条不在过滤消息类型中， eg：需要过滤MsgTypeEnum.notification, 则传入改type note ：该方法返回未读为全量消息未读
    
    参数:
    
    filterMsgTypeSet - 过滤消息类型
    
    返回:
    
    InvocationFuture
  - queryRecentContactsBlock
```
java.util.List<RecentContact> queryRecentContactsBlock(java.util.Set<MsgTypeEnum> filterMsgTypeSet)
```
    查询联系人最近会话列表数据(同步版本)，最近一条不在过滤消息类型中，该方法可能会执行较长时间，建议使用异步版本, note ：该方法返回未读为全量消息未读
    
    参数:
    
    filterMsgTypeSet - 过滤消息类型
  - updateRecent
```
void updateRecent(RecentContact recent)
```
    更新一条最近联系人会话的属性。
    如果想收到MsgServiceObserve.observeRecentContact(Observer, boolean)的通知，可使用updateRecentAndNotify(RecentContact)
    目前可设置的属性有：tag, extension
    
    参数:
    
    recent - 待更新的最近联系人会话数据
  - updateRecentAndNotify
```
void updateRecentAndNotify(RecentContact recent)
```
    更新一条最近联系人会话的属性，并会触发MsgServiceObserve.observeRecentContact(Observer, boolean)的通知。
    如果仅仅是想更新最近联系人会话但不想收到通知，可使用updateRecent(RecentContact) 。
    目前可设置的属性有：tag , extension。
    
    参数:
    
    recent - 待更新的最近联系人数据。
  - updateRecentByMessage
```
void updateRecentByMessage(IMMessage message,
                           boolean needNotify)
```
    通过消息更新一条最近联系人会话。
    如果原来有这个会话，会保留原来的未读数以及tag相关属性
    如果消息的时间比原来的会话小的话，则不会更新
    
    参数:
    
    message - 消息。
    
    needNotify - 是否需要触发MsgServiceObserve.observeRecentContact(Observer, boolean)的通知
  - updateRoamMsgHasMoreTag
```
void updateRoamMsgHasMoreTag(IMMessage newTag)
```
    更新是否有更多漫游消息的标记
    
    参数:
    
    newTag - 需要有相对应的会话ID，会话类型，消息的服务ID和消息时间
  - deleteRecentContact
```
void deleteRecentContact(RecentContact recent)
```
    从最近联系人会话列表中删除一项，既删本地也删漫游。
    调用这个接口删除数据后，不会引发观察者通知。
    
    参数:
    
    recent - 待删除的最近联系人会话项
  - deleteRecentContact2
```
void deleteRecentContact2(java.lang.String account,
                          SessionTypeEnum sessionType)
```
    删除最近联系人记录，既删本地也删漫游。
    调用该接口后，会触发MsgServiceObserve.observeRecentContactDeleted(Observer, boolean)通知
    
    参数:
    
    account -
    
    sessionType -
  - deleteRoamingRecentContact
```
InvocationFuture<java.lang.Void> deleteRoamingRecentContact(java.lang.String contactId,
                                                            SessionTypeEnum sessionTypeEnum)
```
    删除指定最近联系人的漫游消息。不删除本地消息，但如果在其他端登录，当前时间点该会话已经产生的消息不漫游。
    
    参数:
    
    contactId - 最近联系人的ID（好友帐号，群ID等）
    
    sessionTypeEnum - 会话类型
    
    返回:
    
    InvocationFuture 可设置回调函数，监听删除结果。
  - deleteRecentContact
```
InvocationFuture<java.lang.Void> deleteRecentContact(java.lang.String account,
                                                     SessionTypeEnum sessionType,
                                                     DeleteTypeEnum deleteType,
                                                     boolean sendAck)
```
    删除最近联系人记录。
    调用该接口后，不会触发MsgServiceObserve.observeRecentContactDeleted(Observer, boolean)通知
    
    参数:
    
    account - 会话ID
    
    sessionType - 会话类型，只能选SessionTypeEnum.P2P和SessionTypeEnum.Team会删漫游消息
    
    deleteType - 删除类型，决定是否删除本地记录和漫游记录，如果为null，视为DeleteTypeEnum.REMAIN
    
    sendAck - 如果参数合法，是否向本账号的其他端标记清除未读数
  - deleteRoamMsgHasMoreTag
```
void deleteRoamMsgHasMoreTag(java.lang.String sessionId,
                             SessionTypeEnum sessionType)
```
    删除是否有更多漫游的标记
    
    参数:
    
    sessionId - 会话ID
    
    sessionType - 会话类型
  - transVoiceToText
```
AbortableFuture<java.lang.String> transVoiceToText(java.lang.String voiceUrl,
                                                   java.lang.String path,
                                                   long duration)
```
    语音转文字
    
    参数:
    
    voiceUrl - 语音url。可选项。如果没有，SDK自动做nos上传工作。
    
    path - 语音path, 用于获得语音采样率。APP必须保证音频已经下载到本地
    
    duration - 语音时长
    
    返回:
    
    AbortableFuture 调用跟踪。可设置回调函数，可中止下载操作
  - transVoiceToTextAtScene
```
AbortableFuture<java.lang.String> transVoiceToTextAtScene(java.lang.String voiceUrl,
                                                          java.lang.String path,
                                                          long duration,
                                                          java.lang.String sceneKey)
```
    语音转文字并指定上传文件的场景
    
    参数:
    
    voiceUrl - 语音url。可选项。如果没有，SDK自动做nos上传工作。
    
    path - 语音path, 用于获得语音采样率。APP必须保证音频已经下载到本地
    
    duration - 语音时长
    
    sceneKey - 上传文件时用的nos sceneKey ，默认值：NimNosSceneKeyConstant#NIM_DEFAULT_IM ， nos token scene 配置参考NosTokenSceneConfig
    
    返回:
    
    AbortableFuture 调用跟踪。可设置回调函数，可中止下载操作
  - transVoiceToTextEnableForce
```
AbortableFuture<java.lang.String> transVoiceToTextEnableForce(java.lang.String voiceUrl,
                                                              java.lang.String path,
                                                              long duration,
                                                              java.lang.String sceneKey,
                                                              boolean enableForceUploadFile)
```
    语音转文字并指定上传文件的场景以及是否要强制重新上传文件
    
    参数:
    
    voiceUrl - 语音url。可选项。如果没有，SDK自动做nos上传工作。
    
    path - 语音path, 用于获得语音采样率。APP必须保证音频已经下载到本地
    
    duration - 语音时长
    
    sceneKey - 上传文件时用的nos sceneKey ，默认值：NimNosSceneKeyConstant#NIM_DEFAULT_IM ， nos token scene 配置参考NosTokenSceneConfig
    
    enableForceUploadFile - 如果服务器存在相同的文件，是否强制重新上传文件，默认false
    
    返回:
    
    AbortableFuture 调用跟踪。可设置回调函数，可中止下载操作
  - searchRoamingMsg
```
InvocationFuture<java.util.ArrayList<IMMessage>> searchRoamingMsg(java.lang.String otherAccid,
                                                                  long fromTime,
                                                                  long endTime,
                                                                  java.lang.String keyword,
                                                                  int limit,
                                                                  boolean reverse)
```
    云端聊天记录关键词查询
    
    参数:
    
    otherAccid - 对方的account
    
    fromTime - 起始时间点单位毫秒
    
    endTime - 结束时间点单位毫秒
    
    keyword - 搜索的关键词
    
    limit - 本次查询的消息条数上限(最多100条)
    
    reverse - 可选参数，不传默认false，true是表示反向查询(按时间正序起查，正序排列)，默认false表示按时间逆序起查，逆序排列
  - registerIMMessageFilter
```
void registerIMMessageFilter(IMMessageFilter filter)
```
    注册通知消息过滤器
    
    参数:
    
    filter - 上层实现的通知消息过滤器，决定是否过滤通知消息（不存储到数据库中），传 null 表示注销（取消）通知消息过滤器
  - registerShouldShowNotificationWhenRevokeFilter
```
void registerShouldShowNotificationWhenRevokeFilter(ShowNotificationWhenRevokeFilter filter)
```
    注册是否在撤回消息时展示通知的过滤器
  - revokeMessage
```
InvocationFuture<java.lang.Void> revokeMessage(IMMessage message)
```
    消息撤回，默认没有第三方推送（包括IOS平台的推送），参考revokeMessageEx(IMMessage, String, Map)
    
    参数:
    
    message - 待撤回的消息
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - revokeMessageEx
```
InvocationFuture<java.lang.Void> revokeMessageEx(IMMessage message,
                                                 java.lang.String customApnsText,
                                                 java.util.Map<java.lang.String,java.lang.Object> pushPayload)
```
    消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送），如果想要关闭App内的返回消息提醒，参考NIMClient.toggleRevokeMessageNotification(boolean on)
    
    参数:
    
    message - 待撤回的消息
    
    customApnsText - 第三方透传消息推送文本，不填则不推送
    
    pushPayload - 第三方自定义的推送属性，限制json类型，长度2048
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - revokeMessage
```
InvocationFuture<java.lang.Void> revokeMessage(IMMessage message,
                                               java.lang.String customApnsText,
                                               java.util.Map<java.lang.String,java.lang.Object> pushPayload,
                                               boolean shouldNotifyBeCount)
```
    消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考NIMClient.toggleRevokeMessageNotification(boolean on)
    
    参数:
    
    message - 待撤回的消息
    
    customApnsText - 第三方透传消息推送文本，不填则不推送
    
    pushPayload - 第三方自定义的推送属性，限制json类型，长度2048
    
    shouldNotifyBeCount - 撤回通知是否更新未读数
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - revokeMessage
```
InvocationFuture<java.lang.Void> revokeMessage(IMMessage message,
                                               java.lang.String customApnsText,
                                               java.util.Map<java.lang.String,java.lang.Object> pushPayload,
                                               boolean shouldNotifyBeCount,
                                               java.lang.String postscript)
```
    消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考NIMClient.toggleRevokeMessageNotification(boolean on)
    
    参数:
    
    message - 待撤回的消息
    
    customApnsText - 第三方透传消息推送文本，不填则不推送
    
    pushPayload - 第三方自定义的推送属性，限制json类型，长度2048
    
    shouldNotifyBeCount - 撤回通知是否更新未读数
    
    postscript - 附言
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - revokeMessage
```
InvocationFuture<java.lang.Void> revokeMessage(IMMessage message,
                                               java.lang.String customApnsText,
                                               java.util.Map<java.lang.String,java.lang.Object> pushPayload,
                                               boolean shouldNotifyBeCount,
                                               java.lang.String postscript,
                                               java.lang.String attach)
```
    消息撤回，并设置相应的第三方推送配置（包括IOS平台的推送）与未读数变化，如果想要关闭App内的返回消息提醒，参考NIMClient.toggleRevokeMessageNotification(boolean on)
    
    参数:
    
    message - 待撤回的消息
    
    customApnsText - 第三方透传消息推送文本，不填则不推送
    
    pushPayload - 第三方自定义的推送属性，限制json类型，长度2048
    
    shouldNotifyBeCount - 撤回通知是否更新未读数
    
    postscript - 附言
    
    attach - 扩展字段
    
    返回:
    
    InvocationFuture 可设置回调函数，监听发送结果。
  - importRecentSessions
```
InvocationFuture<java.lang.Void> importRecentSessions(java.util.List<<any>> sessions)
```
    导入最近会话，批量导入，仅支持 contactId 和 sessionType 两个字段
    
    参数:
    
    sessions -
    
    返回:
  - checkLocalAntiSpam
```
LocalAntiSpamResult checkLocalAntiSpam(java.lang.String content,
                                       java.lang.String replacement)
```
    检验本地反垃圾词库
    
    参数:
    
    content - 需要检查的文本
    
    replacement - 反垃圾词库命中后替换文本
    
    返回:
    
    LocalAntiSpamResult 检验结果
  - createEmptyRecentContact
```
RecentContact createEmptyRecentContact(java.lang.String contactId,
                                       SessionTypeEnum sessionType,
                                       long tag,
                                       long time,
                                       boolean saveToDB)
```
    创建一条空的联系人会话
    
    参数:
    
    contactId - 会话id ，对方帐号或群组id。
    
    sessionType - 会话类型
    
    tag - 会话tag ， eg:置顶标签（UIKit中的实现： RECENT_TAG_STICKY），用户参照自己的tag 实现即可，如不需要，传 0 即可。
    
    time - 会话时间，单位为ms。
    
    saveToDB - 是否需要将会话保存在DB中，注意以下两点：
    1，如果已经存在相同的会话（contactId 、sessionType 一样），则不会保存在db中；
    2，如果之前不存在相同的会话，且needSaveToDB为true 会触发MsgServiceObserve.observeRecentContact(Observer, boolean)通知；
    
    返回:
    
    InvocationFuture
  createEmptyRecentContact
  
  RecentContact createEmptyRecentContact(java.lang.String contactId, SessionTypeEnum sessionType, long tag, long time, boolean saveToDB, boolean withLastMsg)
  
  创建一条空的联系人会话
  
  参数:
  
  contactId - 会话id ，对方帐号或群组id。
  
  sessionType - 会话类型
  
  tag - 会话tag ， eg:置顶标签（UIKit中的实现： RECENT_TAG_STICKY），用户参照自己的tag 实现即可，如不需要，传 0 即可。
  
  time - 会话时间，单位为ms。
  
  saveToDB - 是否需要将会话保存在DB中，注意以下两点：
  1，如果已经存在相同的会话（contactId 、sessionType 一样），则不会保存在db中；
  2，如果之前不存在相同的会话，且needSaveToDB为true 会触发MsgServiceObserve.observeRecentContact(Observer, boolean)通知；
  
  withLastMsg - 是否放入最后一条消息的相关信息
  
  返回:
  
  InvocationFuture
  
  queryRecentContact
  
  RecentContact queryRecentContact(java.lang.String contactId, SessionTypeEnum sessionType)
  
  根据 contactId 与 sessionType 从db 中查询联系人会话记录。
  
  参数:
  
  contactId - 会话id ，对方帐号或群组id。
  
  sessionType - 会话类型。
  
  返回:
  
  RecentContact ，如果没有，则返回null。
  
  cancelUploadAttachment
  
  InvocationFuture<java.lang.Void> cancelUploadAttachment(IMMessage imMessage)
  
  取消上传消息附件（图片、视频、文件类型的），如果附件已经上传成功，操作将会失败。
  如果成功取消了附件的上传，那么相应的消息会发送失败，对应的消息状态是MsgStatusEnum.fail，附件状态是AttachStatusEnum.cancel
  注意：此操作暂时不支持聊天室
  
  参数:
  
  imMessage - 要取消上传附件的消息
  
  返回:
  
  InvocationFuture
  
  exportAllMessage
  
  AbortableFuture<java.lang.Void> exportAllMessage(IMsgExportProcessor exportProcessor, boolean safeMode)
  
  导出本地db 的所有消息并上传给服务器，对应于导入消息的操作（常用于端到端的历史消息牵移），如果有云端消息记录，不建议使用这个接口
  导入参考importAllMessage(IMsgImportProcessor, boolean safeMode)
  只会导出以下类型的消息：文本消息、图片消息、音频消息、视频消息、文件消息、自定义消息
  
  整个过程如下：
  step1 : 消息转换成文件
  step2 : 压缩文件（用户自定义过程）
  step3 : 加密文件（用户自定义过程）
  step4 : 上传文件
  
  错误码：
  DB中没有数据 : MigrationConstant.EXPORT_ERR_DB_EMPTY
  本地消息格式化失败 : MigrationConstant.EXPORT_ERR_LOCAL_FORMAT
  文件压缩失败(用户自定义过程) : MigrationConstant.EXPORT_ERR_USER_CUSTOM_ZIP
  消息导出时，文件加密失败(用户自定义过程) : MigrationConstant.EXPORT_ERR_USER_CUSTOM_ENCRYPT
  上传文件失败 : MigrationConstant.EXPORT_ERR_UPLOAD_FILE
  消息导出时，本地有消息，但是都被过滤了 : MigrationConstant.EXPORT_ERR_EMPTY_AFTER_FILTER
  
  参数:
  
  exportProcessor - 消息导出处理器，必须设置
  
  safeMode - 是否为安全模式，安全模式下处理完成之后会删除相关的文件（包括用户自定义过程的）
  
  返回:
  
  AbortableFuture
  
  importAllMessage
  
  AbortableFuture<java.lang.Void> importAllMessage(IMsgImportProcessor iMsgImportProcessor, boolean safeMode)
  
  导入已经导出的消息（常用于端到端的历史消息牵移），导出参考exportAllMessage(IMsgExportProcessor, boolean safeMode)
  
  * 整个过程如下：
  step1 : 请求服务器，下载备份文件
  step2 : 解密文件（用户自定义过程）
  step3 : 解压缩文件（用户自定义过程）
  step4 : 解析文件
  
  错误码：
  服务端上没有备份记录 : MigrationConstant.IMPORT_ERR_NO_BACKUP
  服务端返回了备份记录，可是为空 : MigrationConstant.IMPORT_ERR_RECORD_EMPTY
  文件下载失败 : MigrationConstant.IMPORT_ERR_DOWN_FILE
  文件解密失败(用户自定义过程) : MigrationConstant.IMPORT_ERR_CUSTOM_DECRYPT
  文件解压缩失败(用户自定义过程) : MigrationConstant.IMPORT_ERR_CUSTOM_UNZIP
  文件格式错误 : MigrationConstant.IMPORT_ERR_FILE_FORMAT
  部分成功: MigrationConstant.IMPORT_ERR_PART_SUCCESS
  
  参数:
  
  iMsgImportProcessor - 消息导入处理器，必须设置
  
  safeMode - 是否为安全模式，安全模式下处理完成之后会删除相关的文件（包括用户自定义过程的）
  
  返回:
  
  AbortableFuture
  
  clearServerHistory
  
  void clearServerHistory(java.lang.String sessionId, boolean deleteRoam)
  
  清空点对点历史消息
  
  参数:
  
  sessionId - 用户帐号
  
  deleteRoam - 是否删除漫游消息
  
  clearServerHistory
  
  void clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType)
  
  清空点对点历史消息，默认删除漫游消息
  
  参数:
  
  sessionId - 用户帐号
  
  sessionType - 聊天类型
  
  clearServerHistory
  
  void clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType, boolean deleteRoam)
  
  已过时。仅当P2P时，支持保留漫游消息。如果要保留漫游消息，使用clearServerHistory(String, boolean) 如果不保留蛮有消息，使用clearServerHistory(String, SessionTypeEnum)
  
  清空点对点历史消息
  
  参数:
  
  sessionId - 用户帐号
  
  sessionType - 聊天类型
  
  deleteRoam - 是否删除漫游消息
  
  clearServerHistory
  
  void clearServerHistory(java.lang.String sessionId, SessionTypeEnum sessionType, boolean sync, java.lang.String ext)
  
  清空历史消息
  
  参数:
  
  sessionId - 用户帐号
  
  sessionType - 聊天类型
  
  sync - 是否同步给其他端
  
  ext - 扩展字段
  
  deleteRangeHistory
  
  void deleteRangeHistory(java.lang.String account, SessionTypeEnum sessionType, long startTime, long endTime)
  
  根据时间范围删除本地历史消息(startTime， entTime), 开区间，不包括两个端点，大于startTime，小于endTime
  
  参数:
  
  account - 删除账号
  
  sessionType - 删除会话类型
  
  startTime - 开始时间
  
  endTime - 结束时间
  
  queryMySessionList
  
  InvocationFuture<RecentSessionList> queryMySessionList(long minTimestamp, java.lang.Long maxTimestamp, java.lang.Integer needLastMsg, java.lang.Integer limit, java.lang.Integer hasMore)
  
  已过时。
  
  【会话服务】增量获取会话列表，增量+翻页
  
  参数:
  
  minTimestamp - 最小时间戳，作为请求参数时表示增量获取Session列表，传0表示全量获取
  
  maxTimestamp - 最大时间戳，翻页时使用
  
  needLastMsg - 是否需要lastMsg，0或者1，默认1
  
  limit - 结果集limit，最大100，默认100
  
  hasMore - 没用
  
  返回:
  
  InvocationFuture
  
  另请参阅:
  
  queryMySessionList(QueryMySessionOption)
  
  queryMySessionList
  
  InvocationFuture<RecentSessionList> queryMySessionList(QueryMySessionOption option)
  
  【会话服务】增量获取会话列表，增量+翻页
  
  参数:
  
  option - 配置参数
  
  返回:
  
  InvocationFuture
  
  queryMySession
  
  InvocationFuture<RecentSession> queryMySession(java.lang.String sessionId)
  
  【会话服务】获取某一个会话
  
  参数:
  
  sessionId - 分为p2p/team/superTeam，格式分别是：p2p|accid、team|tid、super_team|tid
  
  返回:
  
  InvocationFuture
  
  另请参阅:
  
  com.netease.nimlib.biz.constant.ITalkService.SessionTag
  
  updateMySession
  
  InvocationFuture<java.lang.Void> updateMySession(java.lang.String sessionId, java.lang.String ext)
  
  【会话服务】更新某一个会话，主要是设置会话的ext字段，如果会话不存在，则会创建出来，此时会话没有lastMsg
  
  参数:
  
  sessionId - 分为p2p/team/superTeam，格式分别是：p2p|accid、team|tid、super_team|tid
  
  ext - 会话的扩展字段，仅自己可见
  
  返回:
  
  InvocationFuture
  
  另请参阅:
  
  com.netease.nimlib.biz.constant.ITalkService.SessionTag
  
  deleteMySession
  
  InvocationFuture<java.lang.Void> deleteMySession(java.lang.String[] sessionIdArr)
  
  【会话服务】删除会话
  
  参数:
  
  sessionIdArr - 每一项的格式：分为p2p/team/superTeam，格式分别是：p2p|accid、team|tid、super_team|tid
  
  返回:
  
  InvocationFuture
  
  另请参阅:
  
  com.netease.nimlib.biz.constant.ITalkService.SessionTag
  
  queryThreadTalkHistory
  
  InvocationFuture<ThreadTalkHistory> queryThreadTalkHistory(IMMessage anchor, long fromTime, long toTime, int limit, QueryDirectionEnum direction, boolean persist)
  
  查询thread聊天云端历史（支持p2p、群、超大群）
  
  参数:
  
  anchor - 查找锚点，查找对象为此消息所在的thread中的消息
  
  fromTime - 起始时间
  
  toTime - 终止时间
  
  limit - 条数限制
  
  direction - 方向
  
  persist - 是否持久化
  
  返回:
  
  InvocationFuture
  
  queryReplyCountInThreadTalkBlock
  
  int queryReplyCountInThreadTalkBlock(IMMessage msg)
  
  本地获取某thread消息的回复消息的条数，thread消息不被计入总数
  
  参数:
  
  msg - thread中的某一条消息
  
  返回:
  
  回复消息数
  
  addQuickComment
  
  InvocationFuture<java.lang.Void> addQuickComment(IMMessage msg, long replyType, java.lang.String ext)
  
  增加一条快捷评论
  
  参数:
  
  msg - 回复对象
  
  replyType - 回复类型
  
  ext - 自定义扩展字段，最大8字符
  
  返回:
  
  InvocationFuture
  
  addQuickComment
  
  InvocationFuture<java.lang.Long> addQuickComment(IMMessage msg, long replyType, java.lang.String ext, boolean needPush, boolean needBadge, java.lang.String pushTitle, java.lang.String pushContent, java.util.Map<java.lang.String,java.lang.Object> pushPayload)
  
  增加一条快捷评论
  
  参数:
  
  msg - 回复对象
  
  replyType - 回复类型
  
  ext - 自定义扩展字段，最大8字符
  
  needPush - 是否需要推送
  
  needBadge - 是否需要角标
  
  pushTitle - 推送标题
  
  pushContent - 推送内容
  
  pushPayload - 第三方自定义的推送属性，限制json类型
  
  返回:
  
  InvocationFuture
  
  removeQuickComment
  
  InvocationFuture<java.lang.Void> removeQuickComment(IMMessage msg, long replyType, java.lang.String ext)
  
  删除一条快捷评论
  
  参数:
  
  msg - 回复对象
  
  replyType - 回复类型
  
  ext - 自定义扩展字段，最大8字符
  
  返回:
  
  InvocationFuture
  
  removeQuickComment
  
  InvocationFuture<java.lang.Long> removeQuickComment(IMMessage msg, long replyType, java.lang.String ext, boolean needPush, boolean needBadge, java.lang.String pushTitle, java.lang.String pushContent, java.util.Map<java.lang.String,java.lang.Object> pushPayload)
  
  删除一条快捷评论
  
  参数:
  
  msg - 回复对象
  
  replyType - 回复类型
  
  ext - 自定义扩展字段，最大8字符
  
  needPush - 是否需要推送
  
  needBadge - 是否需要角标
  
  pushTitle - 推送标题
  
  pushContent - 推送内容
  
  pushPayload - 第三方自定义的推送属性，限制json类型
  
  返回:
  
  InvocationFuture
  
  queryQuickComment
  
  InvocationFuture<java.util.List<QuickCommentOptionWrapper>> queryQuickComment(java.util.List<IMMessage> msgList)
  
  获取快捷评论列表
  
  参数:
  
  msgList - 每个元素是被查询快捷评论的消息，数量不超过20
  
  返回:
  
  InvocationFuture
  
  addCollect
  
  InvocationFuture<CollectInfo> addCollect(int type, java.lang.String date, java.lang.String ext, java.lang.String uniqueId)
  
  添加一条收藏
  
  参数:
  
  type - 收藏类型
  
  date - 收藏内容，最大20k
  
  ext - 扩展字段，最大1k
  
  uniqueId - 去重唯一ID
  
  返回:
  
  InvocationFuture
  
  removeCollect
  
  InvocationFuture<java.lang.Integer> removeCollect(java.util.List<<any>> collectInfo)
  
  批量移除收藏
  
  参数:
  
  collectInfo - 要移除的收藏的关键信息组成的列表，每一项为一个Pair，其中第一项为收藏的ID，第二项为收藏的创建时间
  
  返回:
  
  InvocationFuture
  
  另请参阅:
  
  CollectInfo
  
  updateCollect
  
  InvocationFuture<CollectInfo> updateCollect(CollectInfo info, java.lang.String ext)
  
  更新一个收藏的扩展字段
  
  参数:
  
  info - 要更新的收藏
  
  ext - 更新后的扩展字段
  
  返回:
  
  InvocationFuture
  
  updateCollect
  
  InvocationFuture<CollectInfo> updateCollect(long infoId, long createTime, java.lang.String ext)
  
  更新一个收藏的扩展字段
  
  参数:
  
  infoId - 要更新的收藏的ID
  
  createTime - 要更新的收藏的创建时间
  
  ext - 更新后的扩展字段
  
  返回:
  
  InvocationFuture
  
  queryCollect
  
  InvocationFuture<CollectInfoPage> queryCollect(int limit)
  
  从服务查询收藏列表
  
  参数:
  
  limit - 本次查询的消息条数上限(最多100条)
  
  返回:
  
  InvocationFuture
  
  queryCollect
  
  InvocationFuture<CollectInfoPage> queryCollect(CollectInfo anchor, long toTime, int limit, QueryDirectionEnum direction)
  
  从服务端分页查询收藏列表
  
  参数:
  
  anchor - 结束查询的最后一条收藏(不包含在查询结果中)
  
  toTime - 结束时间点单位毫秒
  
  limit - 本次查询的消息条数上限(最多100条)
  
  direction - 查询方向
  
  返回:
  
  InvocationFuture
  
  queryCollect
  
  InvocationFuture<CollectInfoPage> queryCollect(CollectInfo anchor, long toTime, int limit, QueryDirectionEnum direction, int type, boolean persist)
  
  从服务的分页查询收藏列表
  
  参数:
  
  anchor - 结束查询的最后一条收藏(不包含在查询结果中)
  
  toTime - 结束时间点单位毫秒
  
  limit - 本次查询的消息条数上限(最多100条)
  
  direction - 查询方向
  
  type - 收藏类型
  
  persist - 是否持久化
  
  返回:
  
  InvocationFuture
  
  addMsgPin
  
  InvocationFuture<java.lang.Long> addMsgPin(IMMessage msg, java.lang.String ext)
  
  PIN一条消息
  
  参数:
  
  msg - 被PIN的消息
  
  ext - 扩展字段
  
  返回:
  
  InvocationFuture
  
  updateMsgPin
  
  InvocationFuture<java.lang.Long> updateMsgPin(IMMessage msg, java.lang.String ext)
  
  更新一条消息的PIN
  
  参数:
  
  msg - 被PIN的消息
  
  ext - 扩展字段
  
  返回:
  
  InvocationFuture
  
  removeMsgPin
  
  InvocationFuture<java.lang.Long> removeMsgPin(IMMessage msg, java.lang.String ext)
  
  移除一条消息的PIN
  
  参数:
  
  msg - 被PIN的消息
  
  ext - 扩展字段
  
  返回:
  
  InvocationFuture
  
  syncMsgPin
  
  InvocationFuture<MsgPinSyncResponseOptionWrapper> syncMsgPin(SessionTypeEnum sessionType, java.lang.String sessionId, long timestamp)
  
  同步会话的PIN信息
  
  参数:
  
  sessionType - 会话类型
  
  sessionId - 会话ID
  
  timestamp - 时间戳，同步时间戳以后的PIN
  
  返回:
  
  InvocationFuture
  
  queryMsgPinBlock
  
  java.util.List<MsgPinDbOption> queryMsgPinBlock(java.lang.String sessionId, SessionTypeEnum sessionType)
  
  本地获取会话的PIN消息列表
  
  参数:
  
  sessionId - 会话ID
  
  sessionType - 会话类型
  
  返回:
  
  PIN消息列表
  
  addStickTopSession
  
  InvocationFuture<StickTopSessionInfo> addStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)
  
  添加一个置顶会话
  
  参数:
  
  sessionId - 会话ID
  
  sessionType - 会话类型
  
  ext - 扩展字段，最大512字符
  
  返回:
  
  InvocationFuture
  
  removeStickTopSession
  
  InvocationFuture<java.lang.Void> removeStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)
  
  删除一个置顶会话
  
  参数:
  
  sessionId - 会话ID
  
  sessionType - 会话类型
  
  ext - 扩展字段，最大512字符
  
  返回:
  
  InvocationFuture
  
  updateStickTopSession
  
  InvocationFuture<StickTopSessionInfo> updateStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType, java.lang.String ext)
  
  更新一个会话在置顶上的扩展字段
  
  参数:
  
  sessionId - 会话ID
  
  sessionType - 会话类型
  
  ext - 扩展字段，最大512字符
  
  返回:
  
  InvocationFuture
  
  queryStickTopSessionBlock
  
  java.util.List<StickTopSessionInfo> queryStickTopSessionBlock()
  
  获取置顶会话信息的列表
  
  返回:
  
  置顶信息列表
  
  isStickTopSession
  
  boolean isStickTopSession(java.lang.String sessionId, SessionTypeEnum sessionType)
  
  会话是否被置顶，若参数不合法，或者会话不存在，返回false
  
  参数:
  
  sessionId - 会话ID，如果为""或null，返回false
  
  sessionType - 会话类型，如果为null，返回false
  
  返回:
  
  该会话是否被置顶
  
  migrateMessages
  
  void migrateMessages(java.lang.String from, java.lang.String to, boolean changeFrom)
  
  迁移消息聊天记录。将from账号的消息历史数据库合并到to账号的消息数据库中，同时迁移消息记录和最近联系人。
  已存在的最近联系人不会更新。
  
  参数:
  
  from - 源聊天记录账号
  
  to - 目标聊天记录账号
  
  changeFrom - 是否要修改源聊天记录中 IMMessage 的 fromAccount，如果为true，fromAccount由from改为to

接口 MsgService

字段概要

方法概要

字段详细资料

MSG_CHATTING_ACCOUNT_ALL

MSG_CHATTING_ACCOUNT_NONE

方法详细资料

sendMessage

replyMessage

sendFile

insertLocalMessage

saveMessageToLocal

saveMessageToLocalEx

downloadAttachment

queryMessageListByUuidBlock

queryMessageListByUuid

queryMessageListByServerIdBlock

queryMessageListByType

queryMessageListByType

queryMessageListBySubtypeBlock

queryMessageListBySubtype

queryMessageList

queryMessageListEx

queryMessageListExBlock

queryMessageListExTime

queryMessageListByTypes

queryMessageListByTypesV2

queryRoamMsgHasMoreTime

queryRoamMsgHasMoreTimeBlock

queryRoamMsgHasMoreTagServerId

queryRoamMsgHasMoreTagServerIdBlock

pullHistoryById

queryLastMessage

pullMessageHistory

pullMessageHistory

pullMessageHistoryEx

pullMessageHistoryExType

pullMessageHistoryExType

pullMessageHistoryExType

pullMessageHistoryExType

pullMessageHistoryExType

pullMessageHistory

pullMessageHistoryOrderByTime

getMessagesDynamically

searchMessageHistory

searchMessageHistory

searchAllMessageHistory

searchMessage

searchAllMessage

searchAllSession

searchAllSessionBlock

searchSession

searchSessionBlock

deleteChattingHistory

deleteChattingHistory

deleteChattingHistory

clearChattingHistory

clearChattingHistory

clearMsgDatabase

deleteMsgSelf

deleteMsgSelf

everBeenDeleted

setChattingAccount

getTotalUnreadCount

getTotalUnreadCount

getUnreadCountBySessionType

queryUnreadMessageList

queryUnreadMessageListBlock

clearUnreadCount

clearUnreadCount

clearUnreadCount

clearAllUnreadCount

sendMessageReceipt

updateIMMessageStatus

updateIMMessage

registerCustomAttachmentParser

sendCustomNotification

queryRecentContacts

queryRecentContactsBlock

queryRecentContacts