本文介绍网易云信即时通讯 IM SDK（简称 NIM SDK）开发版 Web/uni-app/小程序/RN 端 10.x.x 及以上版本的更新日志。有关 LTS 版 9.x.x 及以下版本，请参考《IM 即时通讯 V9》NIM SDK Web/uni-app/小程序/RN 版更新日志。

10.9.50 (2025-09-15)

新增特性

消息流式处理：普通流式消息现支持携带 RAG 信息，增强 AI 交互能力。

优化

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

API 更新

方法/回调/类	说明
V2NIMAIUser	AI 用户信息结构体中新增 aiModelType 字段，替换原有的 modelType 字段，表示大模型类型。
V2NIMMessageStreamConfig	消息体的流式输出相关配置信息中新增 rag 字段，表示流式消息中携带的 rag 信息。

10.9.40 (2025-08-07)

新增特性

• 新增设置当前聊天账号功能。
• 消息新增在线/离线标志。

优化

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

API 更新

方法/回调/类	说明
V2NIMLocalConversationService.setCurrentConversation	新增接口，用于设置当前的聊天账号。
V2NIMMessageSource	新增枚举，表示消息来源，用于判断在线/离线状态。

10.9.30 (2025-07-18)

新增特性

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

API 更新

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

10.9.20 (2025-07-02)

优化

• 优化好友申请功能。
• 优化入群申请/邀请功能。

API 更新

方法/回调/类	说明
setTeamJoinActionInfoRead	新增接口，用于设置入群申请已读。
getTeamJoinActionInfoUnreadCount	新增接口，用于查询入群申请/邀请的未读数量。
setAddApplicationReadEx	新增接口，用于设置好友申请已读。

10.9.10 (2025-06-18)

API 更新

方法/回调/类	说明
getJoinedTeamMembers	新增方法，用于查询加入群组的成员列表。
getAllTeamMessageMuteMode	新增方法，用于查询自己所在的所有群组的消息免打扰模式。
clearHistoryMessage	更新方法，新增 clearMode 字段，支持配置是否同时删除云端和本地的是历史消息。
getPushMobileOnDesktopOnline	新增方法，用于查询桌面端在线时，移动端是否需要推送。
onPushMobileOnDesktopOnline	新增回调，用于监听当桌面端在线时，移动端是否需要推送。

10.9.0 (2025-05-30)

新增特性

• 支持消息过滤功能。
• 支持查询指定用户是否在黑名单中。
• 新增置顶会话查询能力。
• 支持普通消息流式显示。
• 聊天室支持 LBS 以及 WebSocket 连接。

优化

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

API 更新

方法/回调/类	说明
getMessageListEx	新增方法，用于查询历史消息列表。分页接口，可以根据参数组合查询各种类型，每次默认 50 条消息。
checkBlock	新增方法，用于查看指定用户是否在黑名单中。
V2NIMConversationService.getStickTopConversationList	新增方法，用于查询当前置顶的全量云端会话列表。
V2NIMLocalConversationService.getStickTopConversationList	新增方法，用于查询当前置顶的全量本地会话列表。
setMessageFilter	新增方法，设置消息过滤器，实现消息过滤。
V2NIMMessageFilter	新增对象，表示消息过滤器，用于实现消息过滤。
V2NIMConversation	会话对象新增 name（会话名称）、avatar（会话头像）、mute（会话静音状态）以及 lastReadTime（上一会话已读时间） 字段。
V2NIMMessageListResult	新增查询消息列表返回的数据结构。
V2NIMMessageStreamStatus	消息的流式输出状态。
V2NIMMessageStreamChunk	消息的流式输出最近分片信息。
V2NIMMessageStreamConfig	消息体中的流式输出相关配置信息。若存在该配置信息说明是流式消息，否则是非流式消息。

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.25 (2025-04-08)

修复 uni-app 环境兼容性问题，提升稳定性和性能。

10.8.11 (2025-03-17)

内部优化。

10.8.10 (2025-03-10)

新增特性

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

优化改进

• 优化查询群成员信息的内部逻辑。
• 优化提升连接稳定性。

API 更新

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

10.8.1 (2025-02-25)

优化更新消息功能。

10.8.0 (2025-02-17)

新增特性

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

API 更新

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

10.7.1 (2025-01-20)

问题修复

解决了 uni-app 版本 SDK 被编译成线上资源，应用断线重连后报错 e.getNetworkType is not a function 的问题。

10.7.0 (2024-12-27)

优化

内部多项优化。

API 更新

方法/回调/类	说明
getCollectionListExByOption	新增方法，用于按条件分页获取收藏信息，较 getCollectionListByOption 方法，回参新增 totalCount 字段，表示收藏总数。

10.6.0 (2024-11-20)

新增特性

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

API 更新

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

10.5.0 (2024-10-15)

新增特性

• 优化包体积大小。
• 新增 群成员特别关注 功能。
• 新增自定义消息附件解析器， 用于解析自定义消息各种子类型。
• 新增本地登录信息的查询功能。

API 更新

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

10.4.0 (2024-08-21)

新增特性

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

API 更新

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

10.3.1 (2024-07-18)

• 新增 新版信令 功能。

• SDK 默认上传地址将由 wanproxy-web.127.net 替换为 wannos-web.127.net。

• 小程序和 uni-app 的上传支持多个备份域名。

  • 由于小程序上传地址变更，您需要新增小程序上传域名白名单配置，白名单配置中需要增加关于上传文件（uploadFile）的域名：
    • https://fileup.chatnos.com
    • https://oss.chatnos.com
  • 原来使用的上传域名（https://nos.netease.com）也可以继续保留。

• 其他内部优化。

10.3.0 (2024-07-04)

新增特性

• 新增 AI 数字人功能。详情请参考 AI 数字人。
• 新增根据关键字检索群信息和群成员信息功能。

10.2.7 (2024-05-17)

内部优化。

10.2.6 (2024-05-10)

新增特性

• 新增话单消息类型，用于实现音视频通话功能。
• 新增云端拉取用户信息功能，用于实时感知用户信息的更新。
• 支持生成图片缩略图和视频封面图。
• 新增 Thread 消息查询功能。
• 新增发送消息状态的回调。

优化改进

• 优化好友申请相关数据信息，新增申请者账号和被申请者信息和未读状态信息。
• 优化好友监听回调（V2NIMFriendListener）。

API 更新

方法/回调/类	说明
createCallMessage	新增该方法，用于创建一条话单消息。
imageThumbUrl	新增该方法，用于生成图片缩略图。
videoCoverUrl	新增该方法，用于生成视频封面链接。
getUserListFromCloud	新增该方法，用于根据用户账号列表从服务器获取用户信息。
V2NIMFriendAddApplication	申请添加好友相关操作信息中，新增 applicantAccountId（申请者账号）、recipientAccountId（被申请者账号）、read（是否已读）字段。
V2NIMMessageCallAttachment	新增对象，表示话单消息附件。
V2NIMMessageCallDuration	新增数据结构，表示话单消息单人通话时长。
V2NIMFriendAddApplicationStatus	添加好友申请状态枚举中，新增 V2NIM_FRIEND_ADD_APPLICATION_STATUS_DIRECT_ADD 枚举值，表示直接添加为好友。
getThreadMessageList	分页查询 Thread 历史消息列表。
V2NIMThreadMessageListOption	Thread 消息查询选项。
V2NIMThreadMessageListResult	Thread 消息查询结果。
V2NIMMessageListener	新增发送消息状态的回调（onSendMessage），本端发送消息或插入消息成功后，SDK 会返回该回调。
V2NIMChatroomListener	新增发送聊天室消息状态的回调（onSendMessage），本端发送聊天室消息或插入聊天室消息成功后，SDK 会返回该回调。
V2NIMAddCollectionParams	消息收藏配置参数新增 uniqueId 字段，表示去重唯一 ID，如果 ID 相同，则不会新增收藏，只更新之前的收藏内容。
V2NIMCollection	收藏数据结构新增 uniqueId 字段，表示去重唯一 ID，如果 ID 相同，则不会新增收藏，只更新之前的收藏内容。

10.2.4 (2024-04-08)

新增特性

新增鸿蒙终端类型的解析。

API 更新

方法/回调/类	说明
V2NIMLoginClientType	新增鸿蒙终端类型（V2NIM_LOGIN_CLIENT_TYPE_HARMONY_OS）。

10.2.3 (2024-04-01)

新增特性

新增文件 URL 短链接转长链接功能。

优化改进

• 登录状态新增 未登录。
• 通知消息附件新增 群信息更新 字段。

API 新增

方法/回调/类	说明
shortUrlToLong	新增方法，用于文件 URL 短链接转长链接。

API 变更

方法/回调/类	说明
V2NIMLoginStatus	新增 V2NIM_LOGIN_STATUS_UNLOGIN 未登录状态。
V2NIMMessageNotificationAttachment	新增 updatedTeamInfo 成员参数，用于获取群信息更新字段。类型为 V2NIMUpdatedTeamInfo。

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.1 (2024-03-01)

优化会话置顶功能逻辑。

10.2.0 (2024-01-26)

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

新增特性

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

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

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

改进优化

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

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

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

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