本文介绍网易云信即时通讯 IM SDK（简称 NIM SDK）开发版 macOS/Windows 端 10.x.x 及以上版本的更新日志。有关稳定版 9.x.x 及以下版本，请参考《IM 即时通讯 V9》macOS/Windows 更新日志。

10.9.50 (2025-09-17)

新增特性

• 消息流式处理：普通流式消息现支持携带 RAG 信息，增强 AI 交互能力。
• 群组信息全文检索：新增群组信息本地全文检索接口，支持快速查找群组。
• 群成员信息全文检索：新增群成员信息本地全文检索接口，便于快速定位群成员。

优化

• AI 用户信息：优化 AI 用户信息字段，提供更丰富的 AI 交互体验。
• 登录安全性：优化登录被踢模式，提升账户安全管理。

API 更新

方法/回调/类	说明
searchTeams	新增接口，用于根据关键词全文检索本地的符合条件的群组 ID 和群组名称。
searchTeamMembersEx	新增接口，用于根据关键词全文检索本地的符合条件的群成员信息。
V2NIMMessageSearchExParams	搜索配置参数中新增 tokenize 字段，用于对输入的关键词进行分词。
V2NIMAIUser	AI 用户信息结构体中新增 aiModelType 字段，替换原有的 modelType 字段，表示大模型类型。
V2NIMMessageStreamConfig	消息体的流式输出相关配置信息中新增 rag 字段，表示流式消息中携带的 rag 信息。

10.9.40 (2025-08-08)

新增特性

• 新增设置当前聊天账号功能。
• 新增查询本端当前登录用户的所有数据库信息功能。
• 消息新增在线/离线标志。

优化

• 优化更新消息内部逻辑，去除权限校验。
• 回调失败的消息支持重新发送。

API 更新

方法/回调/类	说明
V2NIMLocalConversationService.setCurrentConversation	新增接口，用于设置当前的聊天账号。
V2NIMStatisticsService.getDatabaseInfos	新增接口，用于查询本端当前登录用户的所有数据库信息。
V2NIMMessageSource	新增枚举，表示消息来源，用于判断在线/离线状态。

10.9.30 (2025-07-18)

新增特性

• 支持删除漫游消息功能。
• 支持在登录时设置登录抄送配置。
• 支持更新群个人名片和群成员昵称时配置是否通过反垃圾审核。
• 优化好友申请功能。
• 优化入群申请/邀请功能。

API 更新

方法/回调/类	说明
clearRoamingMessage	新增接口，用于删除漫游消息。
V2NIMLoginOption	登录配置参数中新增 routeConfig 字段，用于设置登录抄送配置。
V2NIMChatroomLoginOption	聊天室登录配置参数中新增 routeConfig 字段，用于设置聊天室登录抄送配置。
updateSelfTeamMemberInfo	更新接口，在更新自己名片时支持设置 antispamConfig 字段，用于配置是否通过反垃圾审核。
updateTeamMemberNickEx	新增接口，用于更新群成员昵称。 较 updateTeamMemberNick 接口，支持在更新时设置 antispamConfig 字段，配置是否通过反垃圾审核。
setTeamJoinActionInfoRead	新增接口，用于设置入群申请已读。
getTeamJoinActionInfoUnreadCount	新增接口，用于查询入群申请/邀请的未读数量。
setAddApplicationReadEx	新增接口，用于设置好友申请已读。

10.9.10 (2025-06-19)

新增特性

• 全文检索能力支持双向检索。
• 支持普通消息流式显示。
• 支持消息过滤功能。
• 支持查询指定用户是否在黑名单中。
• 新增置顶会话查询能力。

优化

• 优化聊天室 Link 获取逻辑。
• 优化黑名单发送消息失败后漫游消息处理的内部逻辑。

API 更新

方法/回调/类	说明
searchLocalMessages	更新方法，新增 direction 字段，支持双向检索能力。
V2NIMMessageStreamStatus	消息的流式输出状态。
V2NIMMessageStreamChunk	消息的流式输出最近分片信息。
V2NIMMessageStreamConfig	消息体中的流式输出相关配置信息。若存在该配置信息说明是流式消息，否则是非流式消息。
getMessageListEx	新增方法，用于查询历史消息列表。分页接口，可以根据参数组合查询各种类型，每次默认 50 条消息。
checkBlock	新增方法，用于查看指定用户是否在黑名单中。
V2NIMConversationService.getStickTopConversationList	新增方法，用于查询当前置顶的全量云端会话列表。
V2NIMLocalConversationService.getStickTopConversationList	新增方法，用于查询当前置顶的全量本地会话列表。
setMessageFilter	新增方法，设置消息过滤器，实现消息过滤。
V2NIMMessageFilter	新增对象，表示消息过滤器，用于实现消息过滤。
V2NIMConversation	会话对象新增 name（会话名称）、avatar（会话头像）、mute（会话静音状态）以及 lastReadTime（上一会话已读时间） 字段。
V2NIMMessageListResult	新增查询消息列表返回的数据结构。
getJoinedTeamMembers	新增方法，用于查询加入群组的成员列表。
getAllTeamMessageMuteMode	新增方法，用于查询自己所在的所有群组的消息免打扰模式。
clearHistoryMessage	更新方法，新增 clearMode 字段，支持配置是否同时删除云端和本地的是历史消息。
updateLocalMessage	新增方法，用于更新本地插入的消息。
getCloudMessageList	新增方法，用于按条件分页获取云端消息。
getPushMobileOnDesktopOnline	新增方法，用于查询桌面端在线时，移动端是否需要推送。
onPushMobileOnDesktopOnline	新增回调，用于监听当桌面端在线时，移动端是否需要推送。

10.8.30 (2025-04-24)

特性变更

• 新增支持 IM AI 数字人支持流式输出模式，通过实时分片传输 AI 生成的内容，降低响应延迟、支持中断控制，显著改善用户交互体验。
• 优化全文检索云端历史消息。您可以按照指定条件，全局检索整个应用内的云端历史消息。

API 更新

方法/回调/类	说明
searchCloudMessagesEx	新增方法，用于全文检索云端历史消息。
stopAIStreamMessage	新增方法，用于停止 AI 数字人流式输出消息，可以选择直接停止输出，或撤回/更新已输出的 AI 数字人消息。
regenAIMessage	新增方法，用于重新输出 AI 数字人消息，可以选择直接更新覆盖已输出的消息，或者直接创建一条新的 AI 数字人消息。
stopAIModelStreamCall	新增方法，用于向服务器请求停止流式输出 AI 数字人消息。
onProxyAIModelStreamCall	新增 AI 数字人流式输出回调。
sendMessage	接口更新，发送消息的 AI 数字人配置参数中新增输出模式字段（aiStream）字段，选择是否使用流式输出 AI 数字人消息。
proxyAIModelCall	接口更新，向 LLM 发起模型调用请求方法的 AI 数字人配置参数中新增输出模式字段（Stream），选择是否流式输出 AI 数字人消息。

10.8.10 (2025-03-21)

新增特性

支持在初始化 SDK 时配置是否开启 云端会话功能，默认不开启，即默认使用本地会话功能。

优化改进

• 优化查询群成员信息效率。
• 本地历史消息检索功能支持按消息子类型进行过滤。
• 邀请成员入群时支持设置服务端扩展字段。
• 优化提升连接稳定性。

API 更新

方法/回调/类	说明
inviteMemberEx	新增方法，用于邀请成员加入群组。
V2NIMTeamInviteParams	新增数据结构，用于定义邀请成员入群的配置参数。
V2NIMTeamJoinActionInfo	入群操作信息中新增 serverExtension 字段，用于配置扩展信息。
enableCloudConversation	云端会话的配置开关，默认为 false，代表不启用云端会话模式（默认使用本地会话模式）。只有设置为 true 后，才能正常使用 V2NIMConversationService 服务。
V2NIMMessageSearchExParams	本地历史消息检索接口的入参中新增 messageSubtypes 字段，表示自定义消息子类型。

10.8.0 (2025-02-18)

新增特性

• 新增本地会话功能。详情请参考 本地会话管理。
• 支持清空本地历史消息功能。

API 更新

方法/回调/类	说明
clearHistoryMessage	新增 clearMode 入参，可自由选择清空 本地和云端 或 仅本地 的历史消息。
V2NIMLocalConversationService	新增本地会话服务类，提供创建、删除、更新、获取、置顶本地会话，本地会话消息未读数相关、注册本地会话监听等接口。

10.7.0 (2024-12-27)

新增特性

• 新增本地消息全文搜索功能。
• 提升网络联通率与稳定性，支持 QUIC 能力。
• 内部多项优化。

API 更新

方法/回调/类	说明
searchLocalMessages	新增方法，用于全文检索本地历史消息。
getCollectionListExByOption	新增方法，用于按条件分页获取收藏信息，较 getCollectionListByOption 方法，回参新增 totalCount 字段，表示收藏总数。

10.6.1 (2024-12-06)

性能优化

• 优化通过 IM 获取聊天室 token 加入聊天室后，连接超时时间过短的问题。
• 优化网络质量不好的情况下，上传或下载任务时登出阻塞的问题。

问题修复

• 修复特殊场景下解析会话内容偶现的崩溃问题。
• 修复部分场景下断网重连偶现的崩溃问题。
• 修复登出后重新登录的情况下，获取会话 mute 标记不正确的问题。

10.6.0 (2024-11-22)

新增特性

• 新增 聊天室队列服务 功能。
• 新增删除或清空 好友申请 / 入群申请 功能。

API 更新

方法/回调/类	说明
queueOffer	在队列中新增或更新元素。
queuePoll	取出队列中的头元素或指定的元素。
queueList	排序列出所有元素。
queuePeek	查看队列的头元素。
queueDrop	清空队列。
queueInit	初始化队列。
queueBatchUpdate	批量更新队列元素。
addQueueListener	注册聊天室队列监听器。
removeQueueListener	取消注册聊天室队列监听器。
getChatroomQueueService	获取聊天室队列服务（除 Web 端）。
clearAllAddApplication	新增方法，用于清空所有好友申请。
deleteAddApplication	新增方法，用于删除指定的好友申请。
clearAllTeamJoinActionInfo	新增方法，用于清空所有入群申请。
deleteTeamJoinActionInfo	新增方法，用于删除指定的入群申请。
getMessageList	新增 onlyQueryLocal 入参，表示是否只查询本地，默认为 true，只查询本地。

10.5.0 (2024-10-16)

新增特性

• 新增 群成员特别关注 功能。
• 新增自定义消息附件解析器， 用于解析自定义消息各种子类型。
• 新增本地登录信息的查询功能。
• 新增 更新消息 功能，实现消息的二次编辑能力。
• 收藏对象支持唯一并去重。

API 更新

方法/回调/类	说明
addTeamMembersFollow	新增方法，用于添加特别关注群成员列表。
removeTeamMembersFollow	新增方法，用于移除特别关注群成员列表。
createCustomMessageWithAttachment	新增方法，用于构造自定义消息。
registerCustomAttachmentParser	新增方法，用于注册自定义消息附件解析器，解析消息类型（V2NIMMessageType）为 100 的附件。
unregisterCustomAttachmentParser	新增方法，用于反注册自定义消息附件解析器。
getCurrentLoginClient	新增方法，用于查询本地登录的相关信息。
V2NIMUpdatedTeamInfo	新增 customerExtension 字段，表示客户自定义扩展信息。
V2NIMTeamMember	新增 followAccountIds 字段，表示特别关注的群成员账号列表。
V2NIMAddCollectionParams	新增 uniqueId，用于去重。
modifyMessage	新增更新消息接口，用于实现消息的二次编辑能力。

10.4.0 (2024-08-21)

新增特性

• 新增 用户在线状态事件订阅 功能。
• 新增群定向消息功能。发送群消息时，可以指定接收消息的群成员列表。

API 更新

方法/回调/类	说明
V2NIMSendMessageParams	新增 targetConfig 参数，用于实现群定向消息功能。
addSubscribeListener	新增事件监听，用于监听用户订阅相关事件。
removeSubscribeListener	移除事件监听，移除用户订阅相关事件的监听。
publishCustomUserStatus	新增接口，用于发布用户自定义状态。
subscribeUserStatus	新增接口，用于订阅用户状态。
unsubscribeUserStatus	新增接口，用于取消订阅用户状态。
queryUserStatusSubscriptions	新增接口，用于查询用户状态的订阅关系。
错误码	新增群定向消息、消息更新、用户订阅相关错误码。

10.3.1 (2024-07-23)

新增特性

• 新增获取推送免打扰配置详情功能。
• 新增云端拉取用户信息功能，用于实时感知用户信息的更新。
• 新增 新版信令 功能。

API 更新

方法/回调/类	说明
getDndConfig	新增方法，用于获取推送免打扰配置详情。
getUserListFromCloud	新增该方法，用于根据用户账号列表从服务器获取用户信息。

10.3.0 (2024-07-04)

新增特性

• 新增 AI 数字人功能。详情请参考 AI 数字人。
• 新增根据关键字检索群信息和群成员信息功能。
• 新增文件下载功能。
• 新增文件 URL 短链接转长链接功能。
• 新增鸿蒙终端类型的解析。
• 新增话单消息类型，用于实现音视频通话功能。
• 支持生成图片缩略图和视频封面图。
• 新增 Thread 消息查询功能。
• 新增发送消息状态的回调。

优化改进

• 优化修改群组昵称接口的内部逻辑。
• 优化登录逻辑，登录状态新增 未登录。
• 优化通知消息附件的内容，新增 群信息更新 字段。
• 优化好友申请相关数据信息，新增申请者账号和被申请者信息和未读状态信息。
• 优化好友监听回调（V2NIMFriendListener）。

API 变更

方法/回调/类	说明
downloadFile	新增方法，用于下载文件。
shortUrlToLong	新增方法，用于文件 URL 短链接转长链接。
imageThumbUrl	新增该方法，用于生成图片缩略图。
videoCoverUrl	新增该方法，用于生成视频封面链接。
V2NIMLoginStatus	新增 V2NIM_LOGIN_STATUS_UNLOGIN 未登录状态。
V2NIMMessageNotificationAttachment	新增 updatedTeamInfo 成员参数，用于获取群信息更新字段。类型为 V2NIMUpdatedTeamInfo。
V2NIMLoginClientType	新增鸿蒙终端类型（V2NIM_LOGIN_CLIENT_TYPE_HARMONY_OS）。
createCallMessage	新增该方法，用于创建一条话单消息。
V2NIMFriendAddApplication	申请添加好友相关操作信息中，新增 applicantAccountId（申请者账号）、recipientAccountId（被申请者账号）、read（是否已读）字段。
V2NIMMessageCallAttachment	新增对象，表示话单消息附件。
V2NIMMessageCallDuration	新增数据结构，表示话单消息单人通话时长。
V2NIMFriendAddApplicationStatus	添加好友申请状态枚举中，新增 V2NIM_FRIEND_ADD_APPLICATION_STATUS_DIRECT_ADD 枚举值，表示直接添加为好友。
getThreadMessageList	分页查询 Thread 历史消息列表。
getLocalThreadMessageList	查询本地 Thread 历史消息列表。
V2NIMThreadMessageListOption	Thread 消息查询选项。
V2NIMThreadMessageListResult	Thread 消息查询结果。
V2NIMMessageListener	新增发送消息状态的回调（onSendMessage），本端发送消息或插入消息成功后，SDK 会返回该回调。
V2NIMChatroomListener	新增发送聊天室消息状态的回调（onSendMessage），本端发送聊天室消息或插入聊天室消息成功后，SDK 会返回该回调。
addAIListener	新增方法，注册 AI 数字人相关监听器。
removeAIListener	新增方法，移除 AI 数字人相关监听器。
getAIUserList	新增方法，根据用户账号 ID 列表获取 AI 数字人。
proxyAIModelCall	新增方法，AI 数字人向 LLM 发起查询请求。
sendMessage	更新方法，AI 数字人发送消息。
V2NIMAIUser	新增对象。
V2NIMAIModelType	新增枚举。
V2NIMAIModelConfig	新增对象。
V2NIMProxyAIModelCallParams	新增对象。
V2NIMProxyAICallAntispamConfig	新增对象。
V2NIMAIModelCallContent	新增对象。
V2NIMAIModelCallMessage	新增对象。
V2NIMAIModelRoleType	新增枚举。
V2NIMAIModelConfigParams	新增对象。
V2NIMSendMessageParams	更新对象。
V2NIMMessageAIConfigParams	新增对象。
V2NIMMessageAIConfig	新增对象。
V2NIMMessageAIStatus	新增枚举。
V2NIMAIModelCallResult	新增对象。
V2NIMAIListener	新增回调监听对象。
V2NIMMessage	新增对象。

10.2.2 (2024-03-21)

新增特性

• 新增查询未读好友申请数据功能。
• 新增设置好友申请已读功能。
• 新增用户和好友信息检索功能。

优化改进

• 优化群通知附件信息。
• 优化会话名称（V2NIMConversation.name）的显示规则。
• 优化会话最后一条信息，新增消息发送者的用户信息。
• 优化通知消息类型，拆分高级群和超大群的通知消息类型。

API 新增

方法/回调/类	说明
getAddApplicationUnreadCount	新增方法，用于查询未读的好友申请数量。
setAddApplicationRead	新增方法，用于将所有未读的好友申请标记为已读。
searchFriendByOption	新增方法，根据关键字信息搜索好友信息。
searchUserByOption	新增方法，根据关键字信息搜索用户信息。

API 变更

方法/回调/类	说明
V2NIMFriend	新增 userProfile 成员参数，用于获取好友对应的用户信息。
V2NIMMessageNotificationAttachment	新增 updateTeamInfo 成员参数，用于通知消息的群信息更新字段显示。
V2NIMLastMessage	新增 senderName 成员参数，用于获取消息发送者的名称。
V2NIMMessageNotificationType	新增超大群（SUPER_TEAM）相关的通知消息类型，将高级群和超大群的通知消息类型进行拆分。

10.2.0 (2024-01-26)

v10.2.0 版本发布。平台包括 Android、iOS、macOS/Windows、Web（Web/小程序/uniapp）、Linux。

新增特性

• 新增全套新版 API，具体请参考 API 概览。

• 新增云端会话功能，支持在不登录 IM 的情况下，通过相关接口获取会话数据。具体请参考 会话管理。

• 新增云端会话分组功能，支持按照自定义维度将会话进行分组，方便用户管理和查询会话。具体请参考 会话分组管理。

改进优化

• 对于圈组功能，新版本采用融合登录策略，用户只需登录一次，则可以完成 IM 登录与圈组登录。

• 对于聊天室登录模式进行各端一致性优化，聊天室连接地址为用户托管，由用户自行选择聊天室连接地址获取方式。具体请参考 聊天室登录。

• 优化聊天室成员角色分类与操作逻辑，具体请参考 聊天室成员管理：

  V10	V9
  对聊天室成员执行拉黑/解除拉黑操作，聊天室成员角色不变。	黑名单用户为固定成员，移除黑名单后变为游客身份。
  对聊天室成员执行禁言/接触禁言操作，聊天室成员角色不变。	永久禁言用户为固定成员，解除永久禁言后变为游客身份。