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

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)

适用于

Web 端。

新增特性

• 新增 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
  对聊天室成员执行拉黑/解除拉黑操作，聊天室成员角色不变。	黑名单用户为固定成员，移除黑名单后变为游客身份。
  对聊天室成员执行禁言/接触禁言操作，聊天室成员角色不变。	永久禁言用户为固定成员，解除永久禁言后变为游客身份。