• 点对点消息和群聊消息都通过监听MsgServiceObserve.observeReceiveMessage 回调获取，两者通过会话类型进行区分 SessionTypeEnum。 通过NIMClient.getService(MsgServiceObserve.class).observeReceiveMessage(incomingMessageObserver, true)注册消息接收观察者，新消息到达时会收到通知，其中包含 IMMessage的列表。
• 聊天室消息通过监听 ChatRoomServiceObserver.observeReceiveMessage回调获取。 通过NIMClient.getService(ChatRoomServiceObserver.class).observeReceiveMessage(Observer> observer, true)注册聊天室消息接察者，新消息到达时会收到通知，其中包含ChatRoomMessage的列表。

点对点消息、群聊消息以及聊天室消息通过同一个回调 NIMChatManagerDelegate 的 onRecvMessages: 回调获取，三者通过会话类型进行区分 NIMSessionType。

通过 - (void)onRecvMessages:(NSArray *)messages 注册消息接收观察者，新消息到达时会收到通知，其中包含 NIMMessage的列表。

• 点对点消息和群聊消息都通过通过nim_talk_reg_receive_cb注册接收消息全局回调，或者通过nim_talk_reg_receive_msgs_cb注册接收批量消息回调（一个会话为单位），指定接收消息的回调函数nim_talk_receive_cb_func，收到的content中包含消息内容kNIMMsgKeyLocalReceiveMsgContent。两者通过会话类型进行区分 kNIMMsgKeyToType。
  如果是图片、语音消息，SDK会自动下载，然后通过注册的nim_nos_reg_download_cb下载全局回调中指定的回调函数nim_nos_download_cb_func进行通知。
• 通过nim_chatroom_reg_receive_msg_cb注册接收聊天室消息的全局回调，指定接收聊天室消息的回调函数nim_chatroom_receive_msg_cb_func，其中包含聊天室ID和消息内容。

• 点对点消息和群聊消息都通过初始化 SDK 时NIM.getInstance中onmsg注册的回调函数进行通知，其中包含消息对象。两者通过会话类型进行区分 scene。
• 聊天室消息通过初始化聊天室时Chatroom.getInstance中onmsgs注册的回调函数onChatroomMsgs进行通知，其中包含聊天室消息数组。

调用以下接口时，参数ext表示消息的扩展字段。

• https://api.netease.im/nimserver/msg/sendMsg.action：发送普通消息
• https://api.netease.im/nimserver/msg/sendBatchMsg.action：批量发送点对点普通消息
• https://api.netease.im/nimserver/chatroom/sendMsg.action：发送聊天室消息

• 设置消息的扩展字段：

  • 单聊和群聊消息：构造IMMessage对象时，通过setRemoteExtension方法设置消息的服务端扩展字段，通过setLocalExtension方法设置本地客户端扩展字段。
  • 聊天室消息：ChatRoomMessage继承自IMMessage，通过setRemoteExtension方法设置聊天室消息的服务端扩展字段。

• 更新消息的扩展字段： 通过NIMClient.getService(MsgService.class).updateIMMessage(IMMessage message)方法更新消息的本地扩展字段。

• 获取消息的扩展字段：

  • 单聊和群聊消息：通过IMMessage对象的getRemoteExtension()方法获取消息的服务端扩展字段，通过getLocalExtension()方法获取消息的本地扩展字段。
  • 聊天室消息：通过ChatRoomMessage对象的getRemoteExtension()方法获取聊天室消息的服务端扩展字段。

• 设置消息的扩展字段：发送消息时，构造的 NIMMessage对象中，通过remoteExt属性设置消息的服务端扩展字段，通过localExt属性设置消息的本地客户端扩展字段（聊天室消息的本地客户端扩展字段不生效）。

• 更新消息的扩展字段：通过[[NIMSDK sharedSDK].conversationManager updateMessage:(NIMMessage *)message forSession:(NIMSession *)session completion:(nullable NIMUpdateMessageBlock)completion]方法更新消息的本地扩展字段。

• 获取消息的扩展字段：通过NIMMessage对象的remoteExt属性获取消息的服务端扩展字段，通过localExt属性获取消息的本地扩展字段。

• 设置消息的扩展字段：

  • 单聊和群聊消息：调用nim_talk_send_msg 接口发送点对点或群聊消息时，参数json_msg表示消息结构Json Keys，其中kNIMMsgKeyServerExt = "server_ext"表示消息的服务端扩展字段，kNIMMsgKeyLocalExt = "local_ext" 表示消息的本地客户端扩展字段。
  • 聊天室消息：调用nim_chatroom_send_msg接口发送聊天室消息时，参数msg表示消息结构Json Keys，其中kNIMChatRoomMsgKeyExt = "ext"表示聊天室消息的服务器扩展字段。

• 更新消息的扩展字段： 通过nim_msglog_update_localext_async方法更新消息的本地扩展字段，参数msg_id表示消息id，参数local_ext表示消息本地扩展字段内容。

• 获取消息的扩展字段：

  • 单聊和群聊消息：消息结构Json Keys中，kNIMMsgKeyServerExt = "server_ext"表示消息的服务端扩展字段，kNIMMsgKeyLocalExt = "local_ext" 表示消息的本地扩展字段。
  • 聊天室消息：消息结构Json Keys中，kNIMChatRoomMsgKeyExt = "ext"表示聊天室消息的服务器扩展字段。

• 设置消息的扩展字段：
  • 单聊和群聊消息：发送消息时，构造的消息对象中，custom 字段表示消息的服务端扩展字段。 注意：目前设置localCustom本地客户端扩展字段不生效。
  • 聊天室消息：发送聊天室消息时，构造的聊天室消息对象中，custom字段表示聊天室消息的服务端扩展字段。
• 更新消息的扩展字段： 通过如下方法更新消息的本地扩展字段。

  nim.updateLocalMsg({
      idClient: msg.idClient, localCustom: '{"key","value"}',
      done: updateLocalMsgDone
  })
  

• 获取消息的扩展字段：
  • 单聊和群聊消息：通过IMMessage对象的custom字段获取消息的服务端扩展字段，通过localCustom字段获取消息的本地扩展字段。
  • 聊天室消息：通过ChatroomMessage对象的custom字段获取聊天室消息的服务端扩展字段。

调用 MessageBuilder 的各种创建消息的方法时，参数sessionId表示聊天对象ID（消息接收方）。

如果是点对点消息，sessionId 就是对方 accid ；如果是群聊，sessionId 就是群组ID teamId。

调用接口[[NIMSDK sharedSDK].chatManager sendMessage:message toSession:session error:&error]时，session表示消息接收方。

如果是点对点消息，session 就是对方 accid ；如果是群聊，session 就是群组ID teamId。

调用接口 nim_talk_send_msg时，json_msg参数的消息结构Json Keys中，kNIMMsgKeyToAccount表示消息接收方。

如果是点对点消息，kNIMMsgKeyToAccount 就是对方 accid ；如果是群聊，kNIMMsgKeyToAccount就是群组ID kNIMTeamInfoKeyID。

通过nim的各种send方法创建的消息对象中，to字段表示消息接收方。

如果是点对点消息，to 就是对方 accid ；如果是群聊，to 就是群组ID teamId。

调用接口NIMClient.getService(ChatRoomService.class).sendMessage(ChatRoomMessage msg, boolean resend)发送聊天室消息时，确保通过ChatRoomMessageBuilder接口创建的各种消息对象中，包含的roomId参数配置正确。

调用接口[[NIMSDK sharedSDK].chatManager sendMessage:message toSession:session error:&error]发送聊天室消息时，确保其中构造的会话对象NIMSession的会话类型sessionType为NIMSessionTypeChatroom，sessionId配置为正确的聊天室roomId。

调用接口nim_chatroom_send_msg (const int64_t room_id, const char *msg, const char *json_extension)发送聊天室消息时，确保room_id参数配置正确。

通过chatroom的各种send方法发送聊天室消息时，可以通过chatroom.getChatroom(options)方法获取聊天室信息，通过获取成功的回调函数来获取聊天室id。

调用消息发送接口时，设置回调函数：NIMClient.getService(MsgService.class).sendMessage(IMMessage msg, boolean resend).setCallback(callback)，判断是否进入onSuccess回调。

调用消息发送接口[[NIMSDK sharedSDK].chatManager sendMessage:message toSession:session error:&error]时，判断error == nil表示方法调用成功；实现NIMChatManagerDelegate的–sendMessage:didCompleteWithError:方法，判断error == nil表示消息已经发送至服务器。

发送消息状态通过登录前注册的全局回调nim_talk_reg_ack_cb获取，判断result中“发送消息回执Json Keys”的kNIMSendAckKeyMsgId对应的kNIMSendAckKeyRescode是否为kNIMResSuccess = 200。

在消息发送的done回调中根据消息对象的idClient字段和error对象来确定消息的发送状态，error为空表示消息发送成功。

调用接口NIMClient.getService(ChatRoomService.class).sendMessage(ChatRoomMessage msg, boolean resend).setCallback(new RequestCallback<Void>() {})发送聊天室时，如果回调onSuccess表示发送成功。

调用接口[[NIMSDK sharedSDK].chatManager sendMessage:message toSession:session error:&error]发送聊天室消息时，判断error == nil表示方法调用成功；实现NIMChatManagerDelegate的–sendMessage:didCompleteWithError:方法，判断error == nil表示消息已经发送至服务器。

调用接口nim_chatroom_send_msg发送聊天室消息时，发送消息状态通过进入聊天室前注册的全局回调nim_chatroom_reg_send_msg_ack_cb (const char *json_extension, nim_chatroom_sendmsg_arc_cb_func cb, const void *user_data)获取，回调函数typedef void(*nim_chatroom_sendmsg_arc_cb_func) (int64_t room_id, int error_code, const char *result, const char *json_extension, const void *user_data)中，error_code如果为kNIMResSuccess = 200表示发送成功。

通过chatroom的各种send方法发送聊天室消息时，可以通过设置的回调函数done: sendChatroomMsgDone中error参数获取发送结果，如果!error没有错误表示发送成功。

1. 通过接口NIMClient.getService(MsgServiceObserve.class).observeMsgStatus(Observer<IMMessage> observer, true)注册消息状态变化观察者，该接口可以监听消息发送状态变化中回调IMMessage对象。
2. 通过IMMessage对象的getDirect()方法获取消息方向，通过getSessionId()方法获取聊天对象的accid/群组id，通过getContent()方法获取文本消息具体内容，通过getAttachment()方法获取文件消息附件对象，通过getStatus()方法获取消息收发状态，通过getTime()方法获取消息时间（单位为毫秒）。

1. 实现NIMChatManagerDelegate的-sendMessage:didCompleteWithError:方法来接收发送消息完成回调，其中回调NIMMessage对象。可以通过isOutgoingMsg属性判断是否是发送出去的消息。
2. 通过session属性获取聊天对象的accid/群组id/聊天室id，通过text属性获取消息文本（仅适用于文本消息和提示消息），通过messageObject属性获取消息附件内容，通过deliveryState属性获取发送消息的投递状态，通过timestamp属性获取消息发送时间。

1. 通过全局回调nim_talk_reg_ack_cb注册发送消息结果回调函数nim_talk_ack_cb_func，回调result为发送消息回执Json Keys，其中kNIMSendAckKeyMsgId = "msg_id"表示客户端消息id。
2. 通过nim_msglog_query_msg_by_id_async根据消息id查询本地单条消息，回调函数nim_msglog_query_single_cb_func的result为消息结构Json Keys。 其中，kNIMMsgKeyToAccount = "to_accid"表示消息接收方accid/群组id，kNIMMsgKeyBody = "msg_body"表示消息正文，kNIMMsgKeyAttach = "msg_attach"表示消息附件，kNIMMsgKeyTime = "time"表示消息时间戳，kNIMMsgKeyLocalLogStatus = "log_status"表示消息状态NIMMsgLogStatus。

1. 在发送消息接口的done回调中返回IMMessage对象。
2. 通过flow属性获取消息方向，通过to属性获取聊天对象的accid/群组id，通过text属性获取文本消息的内容，通过file属性获取文件消息的文件对象，通过status属性获取消息发送状态，通过time属性获取消息时间戳。

通过useYidun来选择该条消息是否经过安全通，通过配置antispam, antispamCustom来设置自定义消息的反垃圾类型。具体请参考发送消息中的具体参数。

调用 NIMMessage 的 setNIMAntiSpamOption 方法，传递参数为 NIMAntiSpamOption 对象，开发者需要构造这个 NIMAntiSpamOption 对象。其中，content 参数用于说明自定义消息的内容是文本还是图片，以便安全通按照相应类型进行内容安全检测处理。具体请参考安全通文档。

需要对即将发送的消息 NIMMessage 的 antiSpamOption 参数传递 NIMAntiSpamOption 对象，开发者需要构造这个 NIMAntiSpamOption 对象。其中，content 参数用于说明自定义消息的内容是文本还是图片，以便安全通按照相应类型进行内容安全检测处理。具体请参考安全通文档。

需要对即将发送的消息的 kNIMMsgKeyAntiSpamEnable, kNIMMsgKeyAntiSpamContent, kNIMMsgKeyAntiSpamUsingYiDun 参数进行配置，具体请参考安全通文档。

需要对即将发送的消息的 yidunEnable, antiSpamContent, antiSpamUsingYidun 参数进行配置。具体请参考消息配置选项。

调用接口NIMClient.getService(MsgService.class).queryRecentContacts().setCallback(new RequestCallbackWrapper>() {...}时，在onResult中回调最近会话列表（最近联系人列表）。

当有消息收发时，SDK 会通知最近会话更新，需要通过接口NIMClient.getService(MsgServiceObserve.class).observeRecentContact(Observer<java.util.List<RecentContact>> observer, true);注册最近会话列表变化观察者，onEvent中会回调消息列表。

调用接口 NSArray *recentSessions = [NIMSDK sharedSDK].conversationManager.allRecentSessions 获取最近会话列表。

提前监听NIMConversationManagerDelegate中的相应回调方法，当增加、修改、删除最近会话时，SDK 提供对应的回调通知。

• 增加最近会话的回调：-didAddRecentSession:totalUnreadCount:

• 修改最近会话的回调：-didUpdateRecentSession:totalUnreadCount:

• 删除最近会话的回调：-didRemoveRecentSession:totalUnreadCount:

• 最近会话全部加载完成的回调：NIMConversationManagerDelegate的-didLoadAllRecentSessionCompletion

  必须同时满足以下条件，该回调才会执行。

  • SDK 版本为7.0.0及以上。
  • 需要设置NIMSDKConfig的asyncLoadRecentSessionEnabled属性为YES。
  • 本地会话很多，处理耗时较长的情况下：SDK正在查询会话 > 开发者调用allRecentSessions > 此时SDK尚未返回全部会话 > SDK查询完全部会话 > SDK回调-didLoadAllRecentSessionCompletion > 开发者再次调用allRecentSessions获取全量会话并更新UI。
  • 本地会话较少的情况下，当开发者调用allRecentSessions时，如果SDK已经返回全部会话，则不会触发该回调。

调用nim_session.h 中nim_session_query_all_recent_session_async 接口获取最近会话列表，其中 nim_session_query_recent_session_cb_func 注册回调函数，回调的result 为“会话列表的Json Keys”（相关定义在nim_session_def.h中）。

当有消息收发时，SDK 会通知最近会话更新，需要通过接口nim_session_reg_change_cb 注册全局最近会话列表项变更通知，其中nim_session_change_cb_func为回调函数，回调的result为“会话列表的Json Keys”。

根据浏览器是否支持数据库、开发者是否开启数据库的不同，获取到的最近会话不同。

• 浏览器支持数据库时, SDK 会将会话存储于本地数据库中，并且在初始化NIM.getInstance时通过回调onsessions将最多 100 条会话列表返回给开发者，可以调用接口nim.getLocalSessions(options)获取更多最近会话。

  注意：第一次调用nim.getLocalSessions时，不要传入lastSessionId字段。

• 浏览器不支持数据库，或者初始化时配置了禁用数据库，则 SDK 无法在本地维护数据库，最近会话只能依赖消息产生。初始化NIM.getInstance时，配置会话更新回调函数onupdatesession来接收更新会话的回调，包括发送和接收消息、设置当前会话，重置会话未读数等。

• 调用接口NIMClient.getService(MsgService.class).setChattingAccount(account, sessionType)设置当前会话，SDK 会自动管理消息的未读数。
  • 该接口会自动调用clearUnreadCount(account, sessionType)将正在聊天对象的未读数清零。如果有新消息到达，且消息来源是正在聊天的对象，将不会有消息提醒，其未读数也不会递增。
  • 如果收到不是当前聊天对象的新消息，SDK 则会将消息来源的未读数自动累加，并通过开发者注册的观察者接口NIMClient.getService(MsgServiceObserve.class).observeRecentContact(observer, register)进行通知。
  • 如果需要不进入聊天窗口就将未读数清零，可以调用接口NIMClient.getService(MsgService.class).clearUnreadCount(account, sessionType)来实现。
  • 退出聊天界面或离开最近联系人列表界面，需要调用接口NIMClient.getService(MsgService.class).setChattingAccount(MsgService.MSG_CHATTING_ACCOUNT_NONE, SessionTypeEnum.None)来恢复更新未读数(以及通知栏消息提醒)。
• 调用接口NIMClient.getService(MsgService.class).clearAllUnreadCount()设置所有会话消息为已读（所有联系人的未读数清零）。
  调用该接口后，会触发MsgServiceObserve.observeRecentContact(observer, register)通知。

• 调用接口[[NIMSDK sharedSDK].conversationManager markAllMessagesReadInSession:(NIMSession *)session]将一个会话中的所有消息标记为已读。如果是当前会话，每次收到消息都需要调用该接口。
• 调用接口-markAllMessagesRead设置所有会话消息为已读（所有联系人的未读数清零）。

• 调用接口nim_session_set_unread_count_zero_async设置所有会话消息为已读（所有联系人的未读数清零）。如果是当前会话，每次收到消息都需要调用该接口。
• 调用接口nim_msglog_batch_status_read_async来批量设置未读消息为已读状态。

• 调用接口nim.setCurrSession('sessionId')设置当前会话。将此会话未读数置为0，并且此会话收到消息不再更新未读数。
  Web SDK的sessionId，根据会话类型的不同，包含不同的前缀(p2p/team)，例如：p2p-accid，team-teamid。
• 调用接口nim.resetCurrSession()来重置当前会话。重置当前会话后, 所有会话在收到消息之后正常更新未读数。
  此接口和nim.setCurrSession组合起来使用，相当于一对开关。nim.setCurrSession将会话未读数置为0并且不再更新未读数，而nim.resetCurrSession()用来恢复更新未读数。
• 调用接口nim.resetSessionUnread('sessionId')重置会话未读数。将此会话未读数置为0，之后收到消息重新计算未读数。
• 调用接口nim.resetAllSessionUnread()来重置内存中的所有会话未读数。之后收到消息重新计算未读数。

通过最近会话对象 RecentContact 的setExtension(Map extension)方法设置最近会话的扩展字段。

注意：如果希望持久化该字段(保存到数据库中)，请调用NIMClient.getService(MsgService.class).updateRecent(RecentContact recent)或者updateRecentAndNotify(RecentContact recent)更新会话属性(写入数据库)。这两个方法的区别在于后者会触发会话更新的通知。

调用接口-(void)updateRecentLocalExt:(nullable NSDictionary *)ext recentSession:(NIMRecentSession *)recentSession设置最近会话的本地扩展，其中参数ext表示扩展字段，开发者需要确保 NSDictionary 可以转换为JSON。

通过接口nim_session_set_extend_data设置会话项扩展数据，其中参数data表示最近会话的扩展字段。

通过接口nim.updateLocalSession({id:..., localCustom: '{"key", "value"}', done:...})更新本地会话时，其中的localCustom字段表示最近会话的扩展字段。

注意： 如果浏览器不支持数据库，或者对应的会话不存在，SDK都算更新成功。

通过RecentContact最近会话对象的getExtension()方法获取最近会话的扩展字段。

通过NIMRecentSession最近会话对象的localExt属性获取最近会话的扩展字段。

• 通过接口nim_session_query_all_recent_session_async查询会话列表时，回调函数nim_session_query_recent_session_cb_func的result为会话列表的Json Keys。
• 注册nim_session_reg_change_cb最近会话列表项变更通知全局回调，回调函数nim_session_change_cb_func的result为会话列表的Json Keys。

以上两个回调函数的会话列表Json Keys中，kNIMSessionExtendedData = "extend_data"表示最近会话的扩展字段。

通过Session对象的localCustom属性获取最近会话的扩展字段。

收到消息时，会得到IMMessage列表，可以通过NIMMessage的getFromAccount() 和 getFromNick方法获取发送者的 accid 和昵称，再通过getFromNick()方法获取发送方的昵称。

收到消息时，会得到 NIMMessage列表，可以通过NIMMessage对象的from字段获取发送者的 accid，通过 senderName字段获取发送者的昵称（注意是发送者当前的昵称而不是发送消息时的昵称）。

通过接收消息的回调函数 nim_talk_receive_cb_func获取消息内容content，消息结构 Json Keys 中，kNIMMsgKeyFromAccount表示发送者的 accid，kNIMMsgKeyFromNick表示发送者的昵称。

收到消息时，在onmsg回调函数中得到IMMessage消息对象，其中from参数表示发送者的accid，fromNick表示发送者的昵称。

通过 NIMClient.getService(MsgService.class).searchMessageHistory(String keyword, List<String> fromAccounts, IMMessage anchor, int limit).setCallback(new RequestCallbackWrapper<List<IMMessage>>(){ ... }) 方法进行搜素，其中参数keyword表示搜索关键字。

支持基于 Lucene 的全文检索插件，具体请参见开发文档。

通过NIMConversationManager中的–searchMessages:option:result:方法或–searchAllMessages:result:方法进行搜索，在参数option(NIMMessageSearchOption)中指定searchContent进行关键字搜索。

• C: 通过nim_msglog_query_msg_by_options_async方法进行搜索，通过参数search_content指定搜索关键字。
• C++：通过 nim::MsgLog::QueryMsgByOptionsAsync 方法进行搜索，通过参数search_content指定搜索关键字。
• C#：通过NIM.Messagelog.MessagelogAPI.QueryMsglogByCustomCondition方法进行搜索，通过参数searchContent指定搜索关键字。

在开启数据库并且浏览器支持数据库的情况下，可以通过nim.getLocalMsgs方法进行搜索，传入参数keyword进行关键字搜索。

默认关闭未读数多端同步。

可以通过设置SDKOptions对象的sessionReadAck属性为 true 实现。

默认关闭未读数多端同步。

可以通过设置[NIMSDKConfig sharedConfig].shouldSyncUnreadCount = YES 实现。

默认开启未读数多端同步。

可以通过调用 nim_client_init 初始化，在初始化的json_extension扩展参数中，配置kNIMSyncSessionAck为 true 实现。

默认关闭未读数多端同步。

可以通过调用NIM.getInstance初始化，在初始化参数中配置syncSessionUnread: true实现。

• 调用 NIMClient.getService(MsgService.class).saveMessageToLocal(IMMessage msg, boolean notify) 方法或 NIMClient.getService(MsgService.class).saveMessageToLocalEx(IMMessage msg, boolean notify, long time) 方法保存消息到本地数据库，但不发送到服务器。如需通知到 UI，可将入参notify设置为true，调用成功后，会触发MsgServiceObserve.observeReceiveMessage(Observer, boolean)通知。
• 调用 NIMClient.getService(MsgService.class).insertLocalMessage(IMMessage msg, String fromAccount)方法在本地数据库插入一条消息，可以通过参数fromAccount设置消息发送方的 accid，此接口会通知 UI，即调用成功后，会触发MsgServiceObserve.observeReceiveMessage(Observer, boolean)通知。。

通过NIMConversationManager协议的 –saveMessage:forSession:completion: 方法来写入本地消息，方法为异步写入，无须开发者在上层单独开线程，直接在当前线程调用即可。

构造NIMMessage消息对象时，可以通过from字段设置消息发送者的accid，通过timestamp字段设置保存消息的时间。

注意：不允许插入已存在的消息。当保存消息成功之后，会收到NIMChatManagerDelegate中的onRecvMessages:回调。

• C: 通过nim_msglog.h中定义的nim_msglog_insert_msglog_async方法插入本地消息。其中参数need_update_session表示是否更新会话列表（一般最新一条消息会有更新的需求）。参数json_msg中的kNIMMsgKeyFromAccount = "from_id"表示消息发送方accid，kNIMMsgKeyTime = "time"表示消息时间戳。
• C++: 通过nim::MsgLog::WriteMsglogToLocalAsync方法插入本地消息，通过msg的sender_accid_属性指定发送者accid，通过timetag_属性指定消息时间戳。示例代码请点此查看。

发送消息时可以指定参数isLocal为true，那么 SDK 并不会发送此条消息，而是直接调用回调表示发送成功，并更新对应的会话。

可以通过localFrom参数设置发送方的accid，通过time参数设置保存消息的时间。

通过NIMClient.getService(MsgServiceObserve.class).observeAttachmentProgress(Observer observer, true)来注册消息附件上传/下载进度观察者。通过AttachmentProgress的getTotal()方法获取文件总长度，getTransferred()获取已经传输的字节数，getUuid()方法获取附件对应的消息的uuid。

通过uuid查询对应消息的方法为：

• 异步版本：NIMClient.getService(MsgService.class).queryMessageListByUuid(uuids)
• 同步版本：NIMClient.getService(MsgService.class).queryMessageListByUuidBlock(uuids)

• 上传进度： 通过NIMChatManagerDelegate的-sendMessage:progress:方法的progress参数获取附件上传进度。
• 下载进度： 通过NIMChatManagerDelegate的-fetchMessageAttachment:progress:方法的progress参数获取附件下载进度。

• 上传进度： 调用nim_talk_send_msg()发送消息时，配置上传进度的回调函数nim_nos_upload_prg_cb_func，如果发送的消息里包含了文件资源，则通过此回调函数通知上传进度。回调的uploaded_size表示已上传数据大小，file_size表示文件大小。
• 下载进度： SDK默认自动下载附件，没有进度回调，在附件下载完成后才会触发收到消息的回调。
  • 可以在调用nim_client_init初始化SDK时，通过json_extension参数中配置kNIMPreloadAttach = "preload_attach"为false关闭自动下载。
  • 调用nim_nos_download_media进行手动下载时，配置下载进度的回调函数nim_nos_download_prg_cb_func。回调的downloaded_size表示已下载数据大小，file_size表示文件大小。

• 上传进度： 调用nim.sendFile发送文件消息时，通过uploadprogress参数配置上传进度回调函数，例如uploadprogress: function(obj)。其中回调对象obj的total参数表示文件总大小字节数，loaded参数表示已上传的字节数，percentage参数表示上传进度（格式为数字，例如80），percentageText参数表示上传进度文本（格式为百分比，例如80%）。
• 下载进度： 无。

• 调用 NIMClient.getService(MsgService.class).getTotalUnreadCount() 方法获取总未读数。
• 调用 RecentContact的getUnreadCount()方法获取指定会话的未读数。

• 调用 NIMConversationManager的allUnreadCount方法获取总未读数。
• 调用 NIMRecentSession的unreadCount属性获取指定会话的未读数。

通过全局注册nim_session_reg_change_cb来监听最近会话变更。回调函数nim_session_change_cb_func中，total_unread_counts参数表示总未读数，result参数表示[会话列表的Json Keys]，其中kNIMSessionUnreadCount = "unread_count"参数表示对应于会话kNIMSessionId = "id"的未读数。

只能在主线程操作获取未读数。

• 会话(Session)对象的unread值为会话的未读数。
• 总未读数没有直接获取的接口，需要遍历各会话未读数进行累加。

调用NIMClient.init或NIMClient.initSDK 初始化时，配置初始化参数中的SDKOptions对象的animatedImageThumbnailEnabled属性为true。

调用[[NIMSDK sharedSDK] registerWithOption:option]初始化 SDK 之前，配置[NIMSDKConfig sharedConfig].animatedImageThumbnailEnabled = YES。

发送图片消息时，NIMImageObject的–initWithImage:方法只支持 JPEG 和 PNG 两种格式，动图(GIF、WebP)需要通过–initWithFilepath:或–initWithData:extension:方法进行初始化。

• C: 调用nim_client_init初始化时，在初始化参数json_extension中，kNIMAnimatedImageThumbnailEnabled = "animated_image_thumbnail_enabled"表示对缩略图动图的支持，将其设置为true。
• C++: 调用nim::Client::Init初始化时，在初始化参数config中，animated_image_thumbnail_enabled_表示对缩略图动图的支持，将其设置为true。
• C#: 调用NIM.ClientAPI.Init初始化时，在初始化参数config的CommonSetting中，AnimatedImageEnabled表示对缩略图动图的支持，将其设置为true。

暂不支持生成缩略图动图。

调用 IMMessage的setStatus(MsgStatusEnum.read)方法。对于发送的消息，表示对方已读；对于接收的消息，表示自己已读，一般仅用于音频消息。

目前read只是用在了语音消息上，自己播放了就会变为read。对方播放后，本端是无感知的。

注意：此接口只是临时修改内存中的消息状态，如果需要持久化该状态到数据库中，还需要调用NIMClient.getService(MsgService.class).updateIMMessageStatus(message)方法。

设置NIMMessage的isPlayed属性为YES表示消息被播放过(对于聊天室消息无效)。

• nim_msglog_set_sub_status_async设置消息子状态，参数msglog_sub_status类型为NIMMsgLogSubStatus消息子状态枚举值，kNIMMsgLogSubStatusPlayed表示已播放。
• nim_msglog_set_status_async设置消息状态，参数msglog_status类型为NIMMsgLogStatus消息状态枚举值，kNIMMsgLogStatusRead表示收到消息并且已读。
• nim_msglog_batch_status_read_async批量设置未读消息为已读状态。

由于 Web 浏览器不一定支持本地数据库，因此可能导致状态丢失从而表现不符合预期，所以SDK不提供相关接口。如果开发者确实需要在 Web 端实现，建议从应用层自行处理。

建议在Application的onCreate中，SDK初始化之后，注册过滤器。

调用 NIMClient.getService(MsgService.class).registerIMMessageFilter(new IMMessageFilter() { public boolean shouldIgnore(IMMessage message) {...}}) 方法注册过滤器，返回true表示过滤。

在初始化 SDK 时，创建一个NIMSDKConfigDelegate对象，实现下列方法，并将此对象赋值给NIMSDKConfig的delegate属性。

• -(BOOL)shouldIgnoreNotification:(NIMNotificationObject *)notification方法，返回YES表示忽略某条通知消息。
• -(BOOL)shouldIgnoreMessage:(NIMMessage *)message方法，返回YES表示忽略某条普通消息。

目前 IM SDK PC端只支持过滤群通知消息，不支持过滤其他类型的消息。建议在 SDK 初始化之后，登录之前，注册过滤器。

通过nim_talk_reg_notification_filter_cb注册接收群通知消息是否需要过滤的全局回调，其中参数nim_talk_team_notification_filter_func表示群通知消息是否需要过滤的函数定义。

在初始化SDK时，配置以下参数：

• 配置shouldIgnoreNotification参数，表示是否需要忽略某条通知消息。该参数类型为函数(function)，接收一个通知消息对象，如果该函数返回true，那么SDK将忽略此条通知消息。
• 配置shouldIgnoreMsg参数，表示是否要忽略某条普通消息。该参数类型为函数(function)，接收一个消息对象，如果该函数返回true，那么SDK将忽略此条消息。

• 调用 https://api.netease.im/nimserver/msg/delRoamSession.action API 删除漫游消息。
• 调用 https://api.netease.im/nimserver/msg/delMsg.action API 删除指定消息（会删除对应的离线消息、漫游消息和历史消息）。

• 调用 NIMClient.getService(MsgService.class).deleteRoamingRecentContact(contactId, sessionTypeEnum).setCallback(new RequestCallback<Void>() { ... }) 方法删除指定会话的漫游消息。
• 调用 NIMClient.getService(MsgService.class).clearServerHistory(java.lang.String accid, SessionTypeEnum sessionType)方法删除指定会话的历史消息，默认清空漫游消息。
• 调用NIMClient.getService(MsgService.class).clearServerHistory(java.lang.String accid, SessionTypeEnum sessionType, boolean deleteRoam)方法删除历史消息，可设置同时删除漫游消息或仅删除历史下消息。

• 调用 NIMConversationManager的-(void)deleteRemoteSessions:(NSArray *)sessions completion:(nullable NIMRemoveRemoteSessionBlock)completion方法删除指定会话的漫游消息。调用成功后，当前会话之前的消息都不会漫游到其他端。
• 调用 NIMConversationManager的–deleteSelfRemoteSession:option:completion: 方法删除云端历史消息。若不设置删除选项，服务端默认会同时删除漫游消息。

调用以下接口删除会话的云端历史消息和漫游消息。

• C: nim_msglog_delete_history_online_async
• C++: MsgLog::DeleteHistoryOnlineAsync
• C#: NIM.Messagelog.MessagelogAPI.DeleteHistoryOnlineAsync

调用 clearServerHistoryMsgsWithSync 方法删除指定会话的云端历史消息和漫游消息，其中，scene表示消息场景，包括：'p2p'、'team'。

• 当配置scene: 'p2p'时，to表示对方的accid。
• 当配置scene: 'team'时，to表示群ID。

注意：调用成功后，本地数据库中指定会话的消息也会被删除，但是数据库中会话会保留，若需要删除数据库中的会话，可以调用 deleteLocalSession 删除。

• 查询云端记录：
  • 调用NIMClient.getService(MsgService.class).pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes)方法，通过设置msgTypes参数查询指定消息类型的历史消息。该接口查询结果不存本地数据库。
  • 调用NIMClient.getService(MsgService.class).pullMessageHistoryExType(IMMessage anchor, long toTime, int limit, QueryDirectionEnum direction, MsgTypeEnum[] msgTypes, boolean persist)方法，通过设置msgTypes参数查询指定消息类型的历史消息，设置persist参数指定是否将查询结果存入本地数据库。
• 查询本地记录：
  • 调用NIMClient.getService(MsgService.class).queryMessageListByType(MsgTypeEnum msgTypeEnum, IMMessage anchor, int limit)方法，通过设置msgTypeEnum参数查询指定消息类型的历史消息。
  • 调用NIMClient.getService(MsgService.class).queryMessageListByTypes(java.util.List types, IMMessage anchor, long toTime, QueryDirectionEnum direction, int limit, boolean asc)方法，通过设置types参数查询指定消息类型的历史消息。

• 查询云端记录：调用NIMConversationManager的–fetchMessageHistory:option:result:方法，通过设置(NIMHistoryMessageSearchOption *)option的messageTypes参数查询指定消息类型的历史消息。从7.2.0版本开始，NIMHistoryMessageSearchOption中新增参数syncMessageTypes，表示是否将查询结果存入本地数据库。7.2.0(不含)之前的版本，查询结果不存本地数据库。
• 查询本地记录：调用NIMConversationManager的–searchMessages:option:result:和–searchAllMessages:result:方法，通过设置(NIMMessageSearchOption *)option的messageTypes参数查询指定消息类型的历史消息。

• 查询云端记录：调用 MsgLog::QueryMsgOnlineAsync(const QueryMsgOnlineAsyncParam & param, const QueryMsgCallback & cb)，通过设置QueryMsgOnlineAsyncParam的msg_type_list_参数查询指定消息类型的历史消息。
• 查询本地记录：调用MsgLog::QueryMsgByOptionsAsync，通过设置msg_type参数查询指定消息类型的历史消息。

• 查询云端记录：调用{nim.getHistoryMsgs({..., msgTypes: [...], ...})}方法，通过设置 StringArray 类型的msgTypes参数来查询指定消息类型的历史消息。
  支持并开启本地数据库时，可以调用nim.saveMsgsToLocal({msgs: msgs, done: err => (...)})将查询结果存入本地数据库。
• 查询本地记录：调用nim.getLocalMsgs(...)方法，通过设置 String 类型的type参数，或者StringArray类型的types参数来查询指定消息类型的历史消息。
  查询本地记录仅限开启indexedDB数据库时适用。

调用 NIMClient.getService(MsgService.class).deleteMsgSelf(IMMessage msg, String ext).setCallback(...) 方法单向删除消息。

调用 deleteMessageFromServer:ext:completion:方法单向删除消息。

调用以下方法单向删除消息：

• C：nim_msglog_delete_message_self_async
• C++:MsgLog::DeleteMessageSelfAsync

调用 deleteMsgSelf(options: { custom?: string; msg: NIMMessage; done?: any }) 方法单向删除消息。

监听 observeAddQuickComment 事件回调，回调中会返回接收到的快捷评论。

监听 onRecvQuickComment 事件回调，回调中会返回接收到的快捷评论。

监听 RegAddQuickCommentNotify 事件回调，回调中会返回接收到的快捷评论。

监听 onQuickComment 事件回调，回调中会返回接收到的快捷评论。

调用 pullHistoryById 方法根据消息 ID 批量查询历史消息，主要用于消息回复场景。

调用 fetchHistoryMessages:syncToDB:completion: 方法根据消息 ID 批量查询历史消息，主要用于消息回复场景。

调用 QueryMessageOnline() 方法根据消息 ID 等信息查询历史消息，主要用于消息回复场景。

调用 nim.getMsgsByIdServer(options, done) 方法根据消息 ID 等信息查询历史消息，主要用于消息回复场景。

查询选项options参数中的reqMsgs数组的每个元素都是一个对象，包含scene、from、to、idServer、time五个字段，数组长度最大为100。

调用 InvocationFuture>pullMessageHistory(MsgFullKeywordSearchConfig config); 方法，其中MsgFullKeywordSearchConfig的keyword参数表示搜索关键字。

调用 - (void)retrieveServerMessages:(NIMMessageFullKeywordSearchOption *)option result:(nullable NIMRetrieveServerMessagesBlock)result; 方法进行搜素，其中NIMMessageFullKeywordSearchOption的keyword参数表示搜索关键字。

调用 void nim::MsgLog::FullTextSearchOnlineAsync ( const FullTextSearchOnlineAsyncParam & param,const FullTextSearchOnlineAsyncCallback & cb)方法进行搜素，其中FullTextSearchOnlineAsyncParam的keyword参数表示搜索关键字。

调用 msgFtsInServer(options) 方法进行搜素，其中option的keyword参数表示搜索关键字。