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

10.7.0 (2024-12-27)

新增特性

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

API 更新

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

10.6.0 (2024-11-20)

新增特性

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

API 更新

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

10.5.0 (2024-10-15)

新增特性

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

API 更新

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

10.4.1 (2024-09-05)

• 优化提升连接稳定性。
• 新增仅查询本地的消息。

10.4.0 (2024-08-21)

新增特性

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

API 更新

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

10.3.2 (2024-07-19)

• 新增 新版信令 功能。
• 优化推送未读数的内部逻辑。
• 修复已知问题。

10.3.0 (2024-07-04)

新增特性

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

API 更新

方法/回调/类	说明
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.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 历史消息列表。
getLocalThreadMessageList	查询本地 Thread 历史消息列表。
V2NIMThreadMessageListOption	Thread 消息查询选项。
V2NIMThreadMessageListResult	Thread 消息查询结果。
V2NIMMessageListener	新增发送消息状态的回调（onSendMessage），本端发送消息或插入消息成功后，SDK 会返回该回调。
V2NIMChatroomListener	新增发送聊天室消息状态的回调（onSendMessage），本端发送聊天室消息或插入聊天室消息成功后，SDK 会返回该回调。
V2NIMAddCollectionParams	消息收藏配置参数新增 uniqueId 字段，表示去重唯一 ID，如果 ID 相同，则不会新增收藏，只更新之前的收藏内容。
V2NIMCollection	收藏数据结构新增 uniqueId 字段，表示去重唯一 ID，如果 ID 相同，则不会新增收藏，只更新之前的收藏内容。

10.2.4 (2024-04-07)

新增特性

• 新增获取推送免打扰配置详情功能。
• 新增鸿蒙终端类型的解析。
• IM iOS SDK 中新增 PrivacyInfo.xcprivac 隐私文件，兼容苹果公司的隐私更新。

优化改进

• 优化插入本地消息接口（insertMessageToLocal），与其他端对齐参数。
• 优化消息体中的 serverExtension 字段的格式，不强制限定 JSON 格式，但建议使用 JSON。

API 更新

方法/回调/类	说明
getDndConfig	新增获取推送免打扰配置详情的方法。
V2NIMLoginClientType	新增鸿蒙终端类型（V2NIM_LOGIN_CLIENT_TYPE_HARMONY_OS）。

10.2.3 (2024-03-27)

新增特性

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

优化改进

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

API 新增

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

API 变更

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

10.2.2 (2024-03-19)

新增特性

新增用户和好友信息检索功能。

优化改进

• 优化会话最后一条信息，新增消息发送者的用户信息。
• 优化 API 的异步回调逻辑。
• 优化通知消息类型，拆分高级群和超大群的通知消息类型。

API 新增

方法/回调/类	说明
searchFriendByOption	新增方法，根据关键字信息搜索好友信息。
searchUserByOption	新增方法，根据关键字信息搜索用户信息。

API 变更

方法/回调/类	说明
V2NIMLastMessage	新增 senderName 成员参数，用于获取消息发送者的名称。
V2NIMMessageNotificationType	新增超大群（SUPER_TEAM）相关的通知消息类型，将高级群和超大群的通知消息类型进行拆分。

10.2.1 (2024-03-01)

新增特性

• 新增查询未读好友申请数据功能。
• 新增设置好友申请已读功能。

优化改进

• 优化群通知附件信息。
• 优化会话名称（V2NIMConversation.name）的显示规则。

API 新增

方法/回调/类	说明
getAddApplicationUnreadCount	新增方法，用于查询未读的好友申请数量。
setAddApplicationRead	新增方法，用于将所有未读的好友申请标记为已读。

API 变更

方法/回调/类	说明
V2NIMFriend	新增 userProfile 成员参数，用于获取好友对应的用户信息。
V2NIMMessageNotificationAttachment	新增 updateTeamInfo 成员参数，用于通知消息的群信息更新字段显示。

10.2.0 (2024-01-26)

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

新增特性

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

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

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

改进优化

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

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

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

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