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

10.4.2 (2024-09-11)

优化聊天室重复进入逻辑。

10.4.1 (2024-09-05)

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

10.4.0 (2024-08-21)

新增特性

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

优化改进

• 全面升级第三方推送。
• 优化 SDK 的初始化。

适配的第三方推送版本

V10.4.0 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.12.0.300
小米	6.0.1
OPPO	3.5.1
vivo	4.0.0.0_500
魅族	4.3.0
荣耀	7.0.61.303
FCM	firebase-bom:32.3.1 具体版本：firebase-messaging：23.0.0，firebase-analytics: 20.0.0

API 更新

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

10.3.1 (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)

新增特性

• 新增获取推送免打扰配置详情功能。
• 新增鸿蒙终端类型的解析。

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 新增

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