本文介绍了网易云信即时通讯（NIM）提供的 UI 组件（UI Kit）的更新日志，后续简称 IM UIKit。

近期重要更新

• 从 v10.0.0 起，全新 IM UIKit 组件发布，该版本底层适配新版 NIM SDK，即 v10.0.0。
• 从 v9.8.4 起，支持发送视频消息。
• 从 v9.6.0 起，消息页面（包括单聊和群聊）右侧设置栏按钮支持自定义，具体请参考 自定义消息页面右侧设置栏按钮。

---

v10.x.x 及以上版本

10.3.0 (2024-07-16)

新增

• 新增 AI 数字人功能，支持 AI 聊、AI 划词和 AI 翻译功能。详情请参考 AI 数字人概述。
• 支持置顶消息。
• 支持收藏消息。
• 转发支持多选。
• 优化消息发送性能。
• 优化在群组中，陌生人账号首次只有账号 ID（accid）的问题。

变更

IM UIKit 兼容的 NIM SDK 版本升级到 V10.3.0-beta 版本。

10.0.1 (2024-06-03)

升级底层 NIM SDK。

10.0.0 (2024-05-17)

全新 IM UIKit 组件 V10.0.0 版本发布。该版本底层适配新版 IM。

若需要使用该版本，直接引入 @xkit-yx/im-kit-ui v10.0.0 版本即可。

新版本较历史版本，存在部分接口和参数变更，若出现异常，请及时调整，详情请参考 升级指南。

v9.x.x 及以下版本

9.8.4 (2024-02-22)

新增特性

支持发送视频消息。

优化

优化发送图片消息的交互。

修复

修复转让群组后通讯录列表未显示该群组的问题。

9.7.2 (2024-01-11)

支持显示未漫游到的置顶消息。

9.6.5 (2023-11-24)

优化

• 重发消息增加 loading。
• 删除好友时自动解除拉黑的逻辑修改为添加好友时自动解除拉黑。

修复

• Avatar 组件更新 bug fix。
• 修复 IMUIKit context 属性 undefined 问题。

升级

升级 im-store 库。

9.6.2 (2023-09-22)

• 优化性能，提高会话切换的速度。
• 每个会话内的消息缓存数量调整到最新的 20 条。
• 图片消息增加 Blob 链接，提高加载速度和性能。

9.6.0 (2023-08-21)

新增特性

• 消息页面（包括单聊和群聊）右侧设置栏按钮支持自定义，具体请参见 自定义消息页面右侧设置栏按钮。

• 在输入框最右侧新增发送按钮，效果与键盘发送相同。

  

• 支持删除音视频通话消息操作。

  

• 新增群管理员（默认最多设置 10 个）身份，实现群管理功能。

  

  新增的群管理员功能，支持自主开启/关闭显示，用来控制当身份为管理员时的主动操作是否展示，不影响其他管理员身份的显示。默认不显示（不可见），若需要，可在初始化时将 localOptions.teamManagerVisible 设置为 true。

优化

• 优化音视频通话和音视频消息播放冲突问题。
• 对齐 @ 消息的推送相关参数 pushInfo。
• 优化当没有消息时不显示撤回消息的问题。

NIM SDK 版本兼容

IM Web UIKit 兼容的 NIM SDK 版本：V9.11.0

9.5.6 (2023-06-15)

升级必看

UIKit 将 显示单聊/群聊消息的已读未读标记 的配置项（p2pMsgReceiptVisible & teamMsgReceiptVisible）从会话界面（chat-kit）移至初始化配置中（localOptions）。升级至该版本后，如涉及该功能，请及时修改相关代码。

新增特性

• 会话列表支持显示消息的已读未读状态。
• 群组成员列表支持搜索和群成员排序。
• 支持在线/离线状态的展示。
• 群组的群主身份支持转让。
• 支持自定义消息右键操作列表。
• @ 消息支持一键配置。
• 同意好友申请后，打招呼消息支持自定义配置。

优化

• 优化好友数量较多时的卡顿问题。
• 优化图片无边框效果。
• 优化源码集成引用路径。

修复

• 修复撤回功能相关问题。
• 修复个人头像修改失败的问题。
• 修复语音消息与视频消息同时播放的问题。
• 修复交互& UI 展示以及其他已知问题。

NIM SDK 版本兼容

IM Web UIKit 兼容的 NIM SDK 版本：V9.11.0

9.4.2 (2023-05-09)

功能新增

• 会话模块支持一对一音视频通话功能。实现音视频通话的具体说明，请参见 实现音视频通话。
• 新增 @ 功能，支持在群聊中 @ 群成员。
• 支持将单条消息转发至会话。

优化改进

• 优化回复消息功能，采用非 Thread 模式实现。
• 优化好友验证逻辑。

9.3.4 (2023-03-22)

• 包结构调整。
• 修复收不到离线系统通知的问题。
• localOptions 增加 sendMsgBefore 钩子函数，允许用户自定义消息发送前的参数。
• chat 组件支持自定义消息头像和昵称。

0.3.0 (2023-01-17)

组件变更

• chat-kit 新增如下参数：

  • p2pMsgReceiptVisible：是否显示单聊消息的已读和未读标志，boolean 类型，默认 false。
  • teamMsgReceiptVisible：是否显示群聊消息的已读和未读标记，boolean 类型，默认 false。

• localeConfig 中新增字符串，具体参见 语言设置。

功能新增

IM UIKit 新增如下默认支持的功能：

• 支持在 Demo 内进行中英文切换。

  

• 支持设置在群里显示的昵称。

  

• 支持单聊和群聊中的已读和未读标志。

  

• 支持针对某一条消息（包括文本、图片和文件消息）进行引用回复。

  

  

• 支持正常播放从移动端发来的语音消息和视频消息，并且可点击放大查看移动端发来的地理位置。

0.2.1 (2022-12-23)

功能新增

• 多端登录：多端可同时在线登录，登录后消息同步接收、好友关系同步获取、群权限同步更改。
• 好友邀请与申请的处理。
• 好友备注。
• 会话置顶。
• 仅群主可邀请 权限。
• 系统通知：群名称/头像变动、成员进出等。

** API 变更**

• 初始化新增 localOptions 参数。
• 通讯录组件（contact-kit）：
  • ContactList 关系导航组件新增 onItemClick，表示通通讯录导航点击事件。
  • ContactInfo 关系详情组件新增 renderMsgListEmpty 和 renderMsgListHeader 接口，分别用于 自定义渲染消息中心为空时内容 和 自定义渲染消息中心头部内容。
• 会话消息组件（chat-kit）：
  • 原来的自定义渲染聊天消息接口 renderCustomMessage 已废弃，新增 renderP2pCustomMessage 和 renderTeamCustomMessage，分别用于自定义渲染单聊自定义消息和群聊自定义消息。
  • 新增 actions 参数，表示消息发送按钮组配置，不传使用默认的配置。
  • 新增 onSendText 发送文本消息回调函数。
  • 新增 renderTeamMemberItem 接口，用于自定义渲染群成员 Item。
• 会话列表组件（conversation-kit）:
  • 新增 onSessionItemStickTopChange 会话置顶状态变化事件回调。
  • 新增 renderSessionName，用于自定义渲染会话名称。
  • 新增 renderSessionMsg，用于自定义渲染会话消息。
  • 新增 renderP2pSessionAvatar，用于自定义渲染单聊会话头像。
  • 新增 renderTeamSessionAvatar，用于自定义渲染群组会话头像。
• 搜索组件（search-kit）:
  • 新增 renderEmpty 和 renderSearchResultEmpty，分别用于渲染 没有好友和群组时的状态展示 和 没有搜索结果时的自定义渲染。

其他

IM UIKit Store API 参考 上线。

0.2.0 (2022-11-15)

• 新增 Vue Demo，具体说明参见 体验 Demo。也可 跑通 IM Demo 源码 体验网易云信的即时通讯能力。
• 支持基于所有 Web 开发框架（例如 Vue 和 Angular）或者原生 HTML 集成 IM UIKit。如果需要基于 React 以外的 Web 框架及原生 HTML 集成，请参见 非 React 框架集成 IM UIKit。

0.1.0 (2022-9-6)

功能新增

• 新增用户资料组件 MyAvatarContainer。相关说明请参见 集成用户资料组件。

优化改进

• useStateContext 方法中原 state 返回值废弃，新增 store 返回值。基于 Mobx 的数据和 UI 双向绑定能力，store 提供 IM UIKit 内部数据驱动能力，减少用户调用该方法的心智成本。更多相关说明，请参见 全局上下文。
• localeConfig 中部分字符串变更与优化。当前的字符串请参见 语言设置。
• chat-kit 组件中，原 ChatProvider 废弃，且组件参数变更，相关详情请参见 集成会话消息界面。
• contact-kit 组件中，增加 ContactInfo 替代之前的 FriendList、GroupList 和 BlackList，且组件参数变更，相关详情请参见 集成通讯录界面。

0.0.1 (2022-8-3)

IM UIKit 首个版本发布，该版本支持注册与登录、通讯录、会话列表（单聊和群聊）、黑名单和消息收发（文本、表情、图片和文件）等功能，详细功能列表请参见 IM UIKit 功能列表。