跳到主要内容
版本：5.X

更新日志

5.34.0​

发布日期：2025/12/26

功能优化

  1. Electron 平台新增支持搜索 setMessageContent 修改后的消息。
  2. 优化各小程序平台的缓存读写性能，避免线程阻塞。

问题修复

  1. 兼容 UniApp 框架编译打包鸿蒙原生 App 场景，修复断线重连异常。
  2. 修复 Electron 平台单聊会话调用 sendSyncReadStatusMessage 失败问题（影响版本：5.32.0）。
  3. 修复 Electron 平台 disconnect 后，渲染进程内存登录态未及时清理导致的异常（影响版本：5.7.0 - 5.32.0）。
  4. 修复 Electron 平台 getRemoteHistoryMessages 接口 order 为 0 时返回数据排序错误（影响版本：5.28.0 - 5.32.0）。
  5. 修复偶现会话状态同步数据版本缓存错误引发的异常（影响版本：5.20.0 - 5.32.0）。

5.32.0​

发布日期：2025/11/28

新增功能

  1. 优化了单、群聊消息撤回功能，解决 Web 端获取会话历史消息时 RC:RcCmd 撤回消息与实际被撤回消息位置不一致的问题。为保持向前兼容，该优化目前需联系融云客服手动开启。
  2. 新增了机器人信息托管功能，支持获取机器人列表和机器人信息。
  3. Web 端新增了 createConversationListLoader 接口，用于从服务器直接查询标签下的分页会话，解决客户端本地查询接口分页异常问题。

问题修复

  1. 修复了 Web 端偶现的下行数据解析失败引发的异常。
  2. 修复了 Web 端 getFriendAddPermission 接口返回值与接口类型声明不匹配的问题。
  3. 修复了 Web 端主动撤回消息时，本地会话未读数计数错误减 1 的问题。（受影响版本：5.20.0 - 5.30.2）
  4. 修复了 Web 端 removeTagFromConversations 与 removeConversationsFromTag 接口异常。（受影响版本：5.24.0 - 5.30.2）
  5. 修复了 Electron 平台接收群已读回执消息时，本地数据库更新错误的问题。（受影响版本：5.26.0 - 5.30.2）
  6. 修复了 Electron 平台下 RC:RcCmd 撤回消息存储错误，导致获取历史消息时仍能获取到该类型消息的问题。（受影响版本：5.20.0 - 5.30.2）

5.30.1​

发布日期：2025/11/14

新增功能

  1. 退出聊天室接口增加支持透传 extra 信息。

5.30.0​

发布日期：2025/10/31

功能优化

  1. 优化 Web 端 refreshReferenceMessageWithParams 接口响应数据，补全引用消息 content.referMsgStatus 状态数据。
  2. 优化断网情况下 getUserProfiles 接口响应，支持返回本地缓存数据。
  3. 优化 getConversationsFromTagByPage 接口，支持最大获取 1000 条会话，以解决 Web 端可能存在的分页异常问题。
  4. 优化 Web 端事件补偿逻辑，补全断线重连期间的事件通知，涉及逐条消息已读回执（V5）等功能。

问题修复

  1. 修复 Web 端登录账号切换时，偶现 SDK 内部报错的问题。
  2. 修复 APIDoc 及部分 .d.ts 声明文件未正确导出的问题。
  3. 修复 Web 端无法接收到敏感词屏蔽通知的问题（受影响版本：5.26.1 - 5.28.1）。
  4. 修复 Web 端偶现 Events.CONVERSATION 事件未通知变更 time 数据的问题（受影响版本：5.20.0 - 5.28.1）。
  5. 修复 Web 端接收超级群消息时偶现未读数计数错误的问题（受影响版本：5.20.0 - 5.28.1）。

5.28.1​

发布日期：2025/10/10

新增功能

  1. Electron 平台增加支持消息的 isModifyMessage 属性。

问题修复

  1. 修复 Web 端获取历史消息接口返回的数据排序异常、数据异常（受影响版本 5.28.0）。

5.28.0​

发布日期：2025/09/26

非兼容修改

  1. 原 getUnreadMentionedMessages 接口为同步阻塞接口，在 Electron 平台存在性能问题，因此该接口已废弃并失效。SDK 新增 electronExtension.getUnreadMentionedMessages 异步接口，以替代被废弃的接口。

新增功能

  1. Electron 平台新增支持超级群会话类型。
  2. 聊天室功能优化，Electron 平台功能补齐，非 Electron 平台内部逻辑优化，并修复部分已知问题。
  3. getBlockedConversationList 接口新增支持 Electron 平台。
  4. Electron 平台新增 Events.DATABASE_OPENED 事件，用于监控本地数据库正常打开或数据库文件损坏后重建事件。
  5. 新增 getUnreadMentionMeConversationList 接口，用于获取未读的包含 @ 消息的会话列表。
  6. 新增 getSubscribeUsersOnlineStatus 接口，用于查询已订阅用户的在线状态。

功能优化

  1. 优化了 Electron 平台接收大量消息扩展时的写库效率，提升相关场景性能。
  2. 新增了 getConversationListByTimestamp 与 getAllConversationList 接口，用于替换 getConversationList 接口，以避免原接口在不同平台、入参情况下的结果差异性问题。

问题修复

  1. 修复了 Web 端 updateMyUserProfile 更新本人信息后，本地缓存未更新的问题（受影响版本 ≥ 5.24.0）。
  2. 修复了 Web 端会话的 latestMessage 属性中的 targetId 赋值异常问题（受影响版本 ≥ 5.20.0）。
  3. 修复了 Electron 平台 getRemoteHistoryMessages 返回列表顺序错误的问题，与其他端保持一致。
  4. 修复了 Electron 平台 requestSpeechToTextForMessage 接口偶现响应延迟问题（受影响版本 ≥ 5.22.0）。

5.26.2​

发布日期：2025/09/11

新增功能

  1. Electron 平台新增了支持同步服务器端会话列表的能力。
  2. removeConversation 接口增加支持 Electron 平台下删除服务器端会话能力。

问题修复

  1. 修复了 Electron 平台日志模块极端情况下偶现的内存泄露问题（受影响版本为 5.26.0 和 5.26.1）。

5.26.1​

发布日期：2025/09/05

新增功能

  1. 支持了对单聊、群聊已发送成功的消息进行消息编辑。
  2. 优化了 Web 端获取会话列表功能，会话数据中增加 latestMessage 数据。涉及：
    • 获取置顶会话列表：getTopConversationList
    • 获取免打扰会话列表：getBlockedConversationList
    • 获取未读列表：getUnreadConversationList
    • 获取 tag 下的会话列表：getConversationsFromTagByPage
    • 获取指定会话：getConversation
  3. 提供批量会话删除接口 batchDeleteConversations。
  4. 废弃 Electron 平台多进程模式，保持主进程单进程运行，并优化单进程模式下的消息处理性能。

问题修复

  1. 修复了 Web 端可能存在 RTC 业务消息及敏感词拦截通知消息被丢弃的问题。
  2. 修复了 Web 端接收异常消息（content 内容为 "null"）时导致的业务异常。
  3. 修复抖音小程序平台下，应用退至后台再重新进入前台时无法恢复连接问题。
  4. 优化错误入参导致的 Electron 平台运行崩溃问题。

5.24.2​

发布日期：2025/08/14

新增功能

  1. 新增了对快手小程序平台的支持。

问题修复

  1. 修复了 Web 平台偶现会话缓存读取失败导致的业务异常。（受响应版本: 5.24.0 和 5.24.1 ）
  2. 修复了 Electron 平台偶现消息断档引起的过量冗余数据拉取的问题。
  3. 修复了 Electron 平台获取会话（或会话列表）接口偶现的会话的 translateStrategy 属性值异常的问题。
  4. 修复了 Electron 平台偶现的获取好友扩展信息数据丢失的问题。

5.24.1​

发布日期：2025/08/04

问题修复

  1. 修复了偶现翻译功能开关开启时，调用翻译接口无法收到翻译结果事件通知问题。
  2. 修复了 Web 接收聊天室销毁通知后，本地缓存清理异常导致的问题。
  3. 修复了 Electron 平台 getConversation 接口返回值中 translateStrategy 数据错误的问题。

5.24.0​

发布日期：2025/07/25

新增功能

  1. 新增了智能文本翻译功能，可翻译文本消息和任意文本。
  2. 新增了会话状态同步完成通知 Events.CONVERSATIONS_SETTINGS_SYNCE。
  3. 新增了用户级配置同步完成通知 Events.USER_SETTINGS_SYNCED。
  4. 新增了用户级配置变更通知 Events.USER_SETTINGS_CHANGE。
  5. 在 AppSettings 配置查询中增加了 isConversationListIncludeUltraGroup 配置项属性，以查询是否开启“会话列表支持超级群”的功能。
  6. 新增了 electronExtension.getUntaggedConversationListByPage 接口以获取未打标记的会话列表。

问题修复

  1. 修复了偶现 Web 端 getConversationsFromTagByPage 返回的会话列表数据 operationTime 为 0 的问题（受影响版本 ≥ 5.20.0）。
  2. 修复了 Web 端在线收消息时，消息 expantion 拓展数据未解析的问题（受影响版本 ≥ 5.20.0）。
  3. 修复 Electron 平台偶现 PC 设备休眠后唤醒，连接无法恢复的问题（错误码 32061）。
  4. 修复了 V2-Adapter 对老版本上传插件的兼容性问题。
  5. 修复了 Electron 平台 clearHistoryMessages 入参缺少 channelId 时删除失败问题（受影响版本 ≥ 5.20.0）。
  6. 修复了 Web 端调用 setConversationTypeNotificationLevel 接口后，本地缓存数据更新异常的问题。

5.22.0​

发布日期：2025/06/27

新增功能

  1. 新增语音消息转文字功能，可通过开发者后台自行开启。
  2. Electron 平台新增 searchMessageWithParams 接口，支持全局消息搜索。
  3. 新增 getAppSettings 接口以查询功能开关配置，目前版本仅支持查询语音转文字功能。

功能优化

  1. 弱化发送消息时对 needReceipt 的合法性校验，当不符合配置条件时，SDK 将强制修改为 false，不再返回错误码阻塞消息发送。
  2. 新增跨会话获取消息已读人数接口 getMessageReadReceiptInfoV5ByIdentifiers。

问题修复

  1. 修复 Web 端单群聊消息多端同步时，消息 targetId 值错误（受影响版本 ≥ 5.20.0）
  2. 修复 Web 端 getMessagesReadReceiptUsersByPageV5 接口返回的 totalCount 数据错误（受影响版本 ≥ 5.20.0）
  3. 修复 Electron 平台 MESSAGE_RECEIPT_RESPONSE_V5 事件通知中的 totalCount 数据错误（受影响版本 ≥ 5.20.0）
  4. 修复 Web 端 getGroupApplications 接口返回数据的 operationTime 取值错误（受影响版本 ≥ 5.12.0）
  5. 修复 Web 端在未开启“会话列表支持超级群”功能的情况下，getConversationList 返回的会话列表排序异常（受影响版本 ≥ 5.20.0）
  6. 修复 Web 端在弱网情况下，有极低概率偶发单聊、群聊在线消息接收失败问题。
  7. 修复 Web 端删除会话后，接收消息重新生成的新会话置顶、免打扰、会话标签状态丢失问题。（受影响版本 ≥ 5.20.0）
  8. 修复 Electron 平台搜索会话时，messageTypes 与 conversationTypes 参数未空的情况下未返回搜索结果问题（受影响版本 ≥ 5.20.0）
  9. 其他参数校验问题修复。

5.20.2​

发布日期：2025/06/12

问题修复

  1. 修复了 Web 端会话缓存读写错误引发的异常（受影响版本 ≥ 5.20.0）。
  2. 修复了 Electron 平台搜索消息、会话接口，在命中数据失败时与旧版本行为表现不一致问题（受影响版本 ≥ 5.20.0）。
  3. 修复了 sendMessage 调用成功后，返回的 message 数据 needReceipt 属性值错误（受影响版本 ≥ 5.20.0）。

5.20.1​

发布日期：2025/06/03

新增功能

  1. requestStreamMessageContent 接口支持微信小程序平台。

问题修复

  1. 修复加入聊天室后，偶现获取聊天室消息报错问题（受影响版本 ≥ 5.18.0）

5.20.0​

发布日期：2025/05/31

新增功能

  1. 新增“会话列表支持超级群”功能，该功能需提交工单开启；开启后：
    • Web 端将在内存中维护全量单群聊会话列表，并提供 Events.CONVERSATIONS_SYNCED 事件以通知业务层单群聊会话列表同步完成；
    • getConversationList 接口返回的列表数据中将包含超级群默认频道会话；
    • getTotalUnreadCount 返回的未读数中包含超级群默认频道会话未读数据；
    • clearAllMessagesUnreadStatus 接口可用于删除超级群默认频道会话未读数；
    • getTopConversationList 接口获取置顶会话列表时，将包含超级群默认频道会话；
    • getUnreadConversationList 接口获取未读会话列表时，将包含超级群默认频道会话；
  2. removeConversation 接口支持用于删除远端超级群会话
  3. setConversationToTop 接口增加 isCreateConversation、isUpdateTime 参数支持，且支持超级群默认频道会话；
  4. clearAllMessagesUnreadStatus 新增支持 Electron 平台；
  5. 新增 setConversationTypeNotificationLevel、getConversationTypeNotificationLevel 接口，用于定义不同会话类型的默认免打扰等级；
  6. 新增会话逐条消息已读功能(已读回执 v5) 功能，支持接收方对单聊、群聊会话中的消息进行已读标记，支持发送方查询消息已读状态；
  7. getConversation 接口支持获取超级群会话；
  8. disconnect 接口支持传参 disablePush 以禁用离线推送；
  9. IMLib-v2-Adapter 回调函数支持声明为 async 异步函数；
  10. Web 端单、群聊会话增加支持本地缓存会话首条未读消息信息；
  11. electronExtension.searchConversationByContent 新增支持搜索指定会话类型

非兼容变更

  1. Events.ULTRA_GROUP_ENABLE 事件将不再提供回调数据，用户可按需调用接口自行获取超级群会话列表；
  2. getBlockedConversationList 与 getUnreadConversationList 接口数据变更为 IAReceivedConversation[] 列表，提供更多本地缓存的会话信息（如：草稿、未读数等）；
  3. 本端发起的操作（设置会话置顶、免打扰），不再重复对本端回调 Events.CONVERSATION 事件；
  4. electronExtension.setMessageContent 接口第三个参数 messageType 修改为必填参数，以支持搜索修改后的消息内容

问题修复

  1. 修复群组托管功能中，群组申请回调数据异常问题；
  2. 修复 Electron 平台偶发的连接异常问题（受影响版本 ≥ 5.16）
  3. 修复超级群消息发送完成后，本地会话缓存未更新问题
  4. 修复 Web 端收到撤回消息后，未对外通知 Events.CONVERSATION 事件问题（受影响版本 ≥ 5.18.0）
  5. 修复对 RTCLib 的兼容性异常（受影响版本 ≥ 5.14.0）

5.18.0​

发布日期：2025/05/08

重要变更

  1. IMLib-v4-Adapter 正式下线，@rongcloud/imlib-v4-adapter 包最终版本将维持在 5.16.x。

新增功能

  1. 图片消息 content 新增 thumWidth、thumHeight 可选值，以标注缩略图尺寸。

问题修复

  1. 修复了偶现接收到异常下行数据导致的报错问题（对业务无影响）。
  2. 修复同一用户多端同步会话置顶、免打扰数据异常。
  3. 修复发送 @ 消息时的参数校验错误。
  4. 修复 Electron 平台 setMessageStatusToRead 接口在 channelId 传入非字符串数据引起的报错。
  5. 修复 Electron 平台好友删除通知中的 userId 列表数据错误。
  6. 修复 Electron 平台下，接收其他端单聊多端未读状态同步，本地未读数未清理问题（受影响版本：≥5.16.0）。
  7. 修复业务通过调用 Server API 接口设置聊天室 KV 属性后，Electron 平台下业务层接收到两次回调问题。

5.16.1​

发布日期：2025/04/10

问题修复

  1. 修复了 Electron 平台下，IMLib 多端已读状态同步导致对端未读数被清空问题（受影响版本：5.16.0）。

5.16.0​

发布日期：2025/03/28

新增功能

  1. 新增了 "RC:StreamMsg" 流式消息功能，新增 requestStreamMessageContent 方法以拉取流消息内容数据（不支持小程序）。
  2. IM 连接支持纯 IPv6 协议。
  3. 用户信息托管增加用户资料审核，更新数据时若审核失败增加返回失败字段列表。
  4. 撤回消息新增 isAdmin 参数支持，以满足 IMKit 显示需求。
  5. 新增 electronExtension.getLocalMessage 接口，原 getMessage 接口废弃。

问题修复

  1. 修复超级群消息撤回时，撤回接口返回的数据与撤回单群聊消息结果不一致问题，消除接口二义性
  2. 修复 Electron 平台下 getMessage 接口获取本地消息时，数据查询失败仍然后 ErrorCode.SUCCESS 问题；当前修改为返回 ErrorCode.RC_DB_DATA_NOT_FOUND。
  3. 修复将群信息、用户信息字段设置为 "" 或 0 后，相应群信息变更通知缺少变更字段问题。
  4. 修复 Electorn 平台日志写库错误，导致日志内容丢失问题（受影响版本：≥5.12.2）
  5. 修复 Electron 平台下日志上报偶现遗漏、重复问题
  6. 修复 Web 断网情况下，调用发送消息接口后 onSendBefore 回调不执行问题

5.14.1​

发布日期：2025/03/06

问题修复

  1. 修复 @rongcloud/engine 包部分定义未导出，导致 RTC、Call、CallPluls 等业务 SDK 异常；影响版本 5.14.0。
  2. 修复连续快速调用退出、加入聊天室时，偶现进入房间后未拉取 KV 数据的问题。

5.14.0​

发布日期：2025/02/28

新增功能：

  1. Web 端会话列表增加支持 operationTime 字段，用于记录会话操作时间。
  2. Events.GROUP_INFO_CHANGED 事件回调中增加 fullGroupInfo 数据以提供全量群组信息。
  3. 增加设置、查询全局免打扰配置功能。

问题修复

  1. 修复 ELectron 平台下 tag 变更未回调通知的问题。
  2. 修复配置异常可能引发客户端无法接收好友邀请等推送通知问题。
  3. 修复 Electron 单进程模式下运行时，发送消息无法接收到 onBefore 回调问题。
  4. 修复 Electron 平台下，getChatroomEntry 接口响应码与 Web 平台不一致的问题。

重要变更

  1. 各接口响应错误码类型修改为 number。

5.12.4​

发布日期：2025/02/06

问题修复：

  1. 修复了接收消息后未更新本地会话未读数的问题，以及其他缓存错误问题（5.12.3 版本引入）。

v5.12.3​

发布日期：2025/01/17

问题修复：

  1. 修复了 Electron 平台设置会话置顶时，导致免打扰级别变更的问题。
  2. 修复了 searchGroupMembers 接口返回结果格式错误的问题，返回结果中增加 pageToken 字段。

v5.12.2​

发布日期：2024/12/26

新增功能：

  1. 新增了单群聊消息是否更新会话列表中最后一条消息开关。

功能优化：

  1. 修复了聊天室中被封禁后，断网重连后会重新加入的问题。
  2. 修复了子进程重启后已注册的自定义消息丢失的问题。
  3. 修复了子进程崩溃重连失败后无法继续重连的问题。
  4. 修复了 Electron 平台 callInfo 监听返回的数据结构错误的问题。
  5. 优化了 Electron 日志上报数据格式。
  6. 优化了多端同步阅读状态接口增加定向消息回话类型过滤。

v5.12.1​

发布日期：2024/10/28

功能优化：

  1. 修复了子进程崩溃重启时 token 或 navi 过期会导致无法重连的问题。
  2. 当传递的参数 count 出错的时候， getFriends 和 getFriendApplications 接口返回的错误码从 34328 改为 34232。
  3. 修复了子进程启动 updateGroupInfo 接口扩展字段默认值无法赋值的问题。

v5.12.0​

发布日期：2024/10/18

新增功能：

  1. 信息托管服务中新增群组及成员管理能力。
  2. 信息托管服务中新增好友关系管理能力。

功能优化：

  1. 修复 Web 端 未开启用户状态订阅，仅开启用户信息托管 时，获取用户资料报错的问题。
  2. 修复插入消息后，消息 content 为空的问题。

v5.10.4​

发布日期：2024/08/29

功能优化：

  1. 适配在 uniapp 平台使用 Vue3 框架编译为 APP 端时的兼容问题。
  2. Electron 平台增加数据库升级回调事件。

v5.10.3​

发布日期：2024/07/30

新增功能：

  1. 加入聊天室的接口返回中增了加入时间。
  2. 发送消息支持设置 HarmonyOS 推送属性。
  3. 在线状态订阅支持了 HarmonyOS 平台。

问题修复：

  1. 修复了发送图片消息的缩略图有黑边的问题。

v5.10.2​

发布日期：2024/07/02

功能优化：

  1. 修改置顶空会话同步功能默认为 false。

v5.10.1​

发布日期：2024/06/28

新增功能：

  1. 新增用户信息托管功能
  2. Electron 平台支持关闭置顶空会话同步

问题修复：

  1. 修复 searchMessages 接口返回 count 可能为 undefined 的问题
  2. 修复非群聊会话中会可能会携带 mentionedInfo 的问题
  3. 修复发送 RC:SRSMsg 时，Content 中的 lastMessageSendTime 字段传错的问题

v5.9.9​

发布日期：2024/06/05

新增功能：

  1. Electron 平台新增了 批量获取会话信息 方法。

问题修复：

  1. 修复了实时日志请求 URL 有特殊字符导致请求失败的问题。
  2. 修复了不能给系统会话发送 RC:SRSMsg 消息的问题。
  3. 修复了日志数据库升级可能会报错的问题。
  4. 修复了 Electron 本地插入 RC:RcNtf 消息的发送状态异常的问题。
  5. 修复了在 Electron 平台，RTC 信令发送和解析失败的问题。
  6. 修复了连接时连续收到多个 30021 导致子进程崩溃的问题。
  7. 修复了批量插入消息 latestMessage 更新问题。
  8. 修复了应用退出，子进程会重启的问题。

v5.9.8​

发布日期：2024/04/29

新增功能：

  1. 新增了在线状态订阅功能。
  2. 新增了撤回消息支持发送定向通知的能力。
  3. Electron 平台新增了 获取本地指定时间戳前后 N 条消息 方法。
  4. Electron 平台搜索本地指定会话历史消息接口支持传入消息类型。

问题修复：

  1. 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。
  2. 修复了导出 CombineV2Message 错误。

v5.9.7​

发布日期：2024/04/01

问题修复：

  1. 修复了使用 NPM 下载 IMLib-next 包时报错的问题。

v5.9.6​

发布日期：2024/03/29

新增功能：

  1. 定向消息中增加了指定接收消息的目标用户列表。
  2. 引用消息中增加了被引用的唯一标识 referMsgUid。
  3. 新增了 electronExtension.getContinuousMessages 接口，用以同时查询本地与远端历史消息。

问题修复：

  1. 修复了重连报 30021 时没有重连的问题。
  2. 修复了主动撤回消息后，在消息监听中收到重复的撤回消息通知的问题。

优化功能：

  1. 适配 Electron 平台开启上下文隔离场景。

v5.9.5​

发布日期：2024/01/31

优化功能：

  1. 消息数据中的 receivedStatusInfo 改为可选，解决 TS 开发中可能存在的报错。

v5.9.4​

发布日期：2024/01/31

新增功能：

  1. 超级群支持发送定向消息功能
  2. 超级群支持按消息 Uid 批量删除消息
  3. 空会话置顶支持多端同步
  4. 获取会话列表功能增加参数是否按置顶状态排序
  5. Electron 平台新增获取全部 @ 消息未读数接口
  6. Electron 平台新增发送状态消息功能

问题修复：

  1. 修复发送图片消息时，缩略图质量参数 quality 无效的问题
  2. 修复 Electron 平台发送状态消息异常问题

优化功能：

  1. 优化群消息已读回执功能

v5.9.3​

发布日期：2023/12/18

新增功能：

  1. Electron 平台新增 setMessageReceivedStatusInfo 方法

优化功能：

  1. 单聊已读回执回调参数中增加 sendUserId 用于判断是自己还是对方发的
  2. 优化多设备登录收取离线消息时消息回执监听触发早于消息监听

问题修复：

  1. 修复 removeChatRoomEntries 接口参数 ts 类型定义错误
  2. 修复会话状态变更通知里的时间不对的问题

v5.9.2​

发布日期：2023/12/13

问题修复：

  1. 修复 Electron 在 Windows 平台发送消息接口响应延迟高的问题
  2. 修复 Electron 在 Windows 平台拉大量离线消息时应用卡顿的问题
  3. 接口 addConversationsToTag 增加限制，会话列表不能为空

v5.9.1​

发布日期：2023/11/28

问题修复：

  1. 修复 Node 14 以下版本无法下载 @rongcloud/electron 依赖包的问题

v5.9.0​

发布日期：2023/11/23

新增功能：

  1. 消息拓展变更通知（Events.EXPANSION）回调数据 IExpansionListenerData 中补充会话信息。从 5.9.0 开始，IUpdatedExpansion 与 IDeletedExpansion 均返回 conversationType 和 targetId。
  2. 聊天室成员加入、退出通知 (Events.CHATROOM) 回调 IChatroomUserChangeInfo 中增加当前聊天室人数 memberCount。
  3. 新增 getAllUnreadMentionedCount 接口，支持获取所有会话类型的未读 @ 消息数。
  4. 获取会话列表接口返回的会话数据 IAReceivedConversation 中增加草稿字段 draft。
  5. 新增 getFirstUnreadMessageInfo 接口，支持获取第一条未读消息信息。
  6. 支持荣耀推送配置，可在发送消息时通过 IPushConfig 下的 IAndroidPushConfig 控制荣耀推送的消息提醒级别与通知栏图片。

问题修复：

  1. 小程序平台不再请求动态导航地址
  2. 修复可能收不到敏感词拦截通知的问题
  3. 修复发送@消息时，会话中的@字段错误的问题
  4. 修复高频调用 tag 和会话状态相关接口时报 26002 的问题
  5. Electron 平台修复发送撤回消息后,再次拉到撤回消息时原始消息被修改两次的问题
  6. 修复 Electron 的 Windows 平台退出时卡死的问题
  7. 优化消息量大时，在 Windows 平台会导致应用卡顿问题

v5.8.5​

发布日期：2023/10/27

优化功能：

  1. 优化 SDK 日志上传机制

问题修复：

  1. 修复发送 @ 消息时，会话中的 @ 字段错误的问题

v5.8.4​

发布日期：2023/09/25

新增功能：

  1. Electron 平台支持免打扰级别功能
  2. 会话列表中增加 operationTime 字段（仅 Electron 平台支持）

问题修复：

  1. 修复加入聊天室后，刷新页面并连接后会自动重新加入的问题
  2. 修复插入本地的撤回消息已读状态错误的问题（Electron 平台）
  3. 修复并发上传语音消息时报错的问题

v5.8.3​

发布日期：2023/08/31

新增功能：

  1. 多端同步会话未读数功能支持系统会话。
  2. 发送文件消息（上传）支持携带 @ 信息。
  3. 加入聊天室接口返回房间信息与用户状态信息，例如是否禁言、是否在禁言白名单中、聊天室人数等。
  4. 在 Electron 平台，如果消息被撤回时本地数据库已不存在该消息，仍然插入一条 RC:RcNtf 类型消息。

v5.8.2​

发布日期：2023/07/28

新增功能：

  1. Electron 平台支持 win32 X64 架构
  2. Electron 平台增加处理多端同步消息 RC:ReadNtf
  3. Electron 平台适配上传功能

问题修复：

  1. 修复服务器重启后可能导致连接不成功的问题
  2. 修复支付宝小程序连接报错问题

v5.8.1​

发布日期：2023/07/14

新增功能：

  1. 新增小灰条消息（RC:InfoNtf）、命令消息（RC:CmdMsg）、群组通知消息（RC:GrpNtf）的发送

v5.8.0​

发布日期：2023/07/3

新增功能：

  1. 超级群查询未读 @ 消息增加返回消息类型属性

问题修复：

  1. 修复断网重连偶现导致触发心跳问题。

其他：

  1. 小程序平台安全域名调整：安全域名

v5.7.10​

发布日期：2023/06/15

新增功能：

  1. 新增接口 getUltraGroupUnreadInfoList, 支持批量获取超级群会话未读信息
  2. Electron 平台新增接口searchMessagesByUser, 支持根据发送者ID 搜索本地单群聊会话消息

问题修复：

  1. 修复撤回超级群 @ 消息时，未读 @ 数减一异常的问题。
  2. 修复拉取超级群消息可能陷入死循环的问题。

v5.7.9​

发布日期：2023/05/29

新增功能：

  1. 新增聊天室状态通知(封禁、禁言、加入/退出多端状态同步)
  2. Electron 平台增加在收到 30019、30021 状态码时 SDK 会自动发起重连逻辑
  3. 初始化增加区域码设置
  4. 超级群获取频道列表接口增加 @ 我的未读消息数属性

问题修复：

  1. 修复超级群收到撤回消息时，未读消息数异常问题
  2. 修复支付宝小程序平台重新连接时会建立两个 socket 连接的问题

v5.7.8​

发布日期：2023/05/11

新增功能：

  1. IMLib 的 Electron平台增加对草稿的操作

问题修复：

  1. uniapp 打包 app 链接不上
  2. IE 浏览器不再支持日志存储, 因为 indexDB 不支持 getAllKeys 方法

v5.7.7​

发布日期：2023/04/21

问题修复：

  1. 修复获取免打扰列表 notificationLevel 值 undefined。
  2. 修复 Electron 平台获取全部会话列表无法获取系统会话的问题。

其他：

  1. 增加处理多端同步 RC:ReadNtf 消息逻辑。
  2. 消息推送属型配置 IPushConfig.androidConfig 新增 categoryVivo 字段。如果指定了 categoryVivo ，必须同时指定匹配的 typeVivo。该字段优先级高于控制台为 App Key 下的应用标识配置的 vivo 推送 Category。
    • categoryVivo 字段对应 vivo 推送服务的消息二级分类（category 字段）。详细取值请参见 vivo 推送消息分类说明。
    • typeVivo 字段对应 vivo 推送服务的消息分类（classification 字段，区分系统消息、运营消息）。请注意遵照 VIVO 官方要求，确保二级分类（category）取值属于 classification下允许发送的内容。详细取值请参见 vivo 推送消息分类说明。

v5.7.5​

发布日期：2023/04/12

问题修复：

  1. 优化 5.4.7 之前版本禁用资源 pb 报错。

v5.7.4​

发布日期：2023/03/30

问题修复：

  1. 修复无法获取到未设置免打扰级别和免打扰状态的未读数的问题。
  2. 修复在 web 平台，会收到自己设置的聊天室 kv 的通知的问题。
  3. 修复偶现 Cannot read property 'kvStorage' of null 的问题。
  4. 修复断网重连后再发消息时，偶发消息监听中收到自己发送的消息的问题。

其他：

  1. 获取历史消息接口，count 字段范围改为 0-100，超出将报错。
  2. 获取指定会话接口（getConversations）针对超级群会话类型，返回值增加 firstUnreadMessage 和 channelType 字段

v5.7.3​

发布日期：2023/03/02

新增功能：

  1. 增加超级群用户组通知监听
  2. 消息推送属型配置 IPushConfig.androidConfig 支持华为推送参数
    1. categoryHW ： 华为推送消息分类
    2. importanceHW ： 华为推送消息级别
    3. imageUrlHW：华为通知类型的推送所使用的通知图片 url
  3. 消息推送属型配置 IPushConfig.androidConfig 支持消息推送参数
    1. miLargeIconUrl：小米 Large icon 链接

问题修复：

  1. 修复按会话免打扰级别获取未读数接口设置 levels 参数不生效问题
  2. 修复发送 @ 消息后，发送方自己收到 @ 消息的会话变更问题
  3. 修复获取免打扰的会话列表返回的 notificationlevel 字段值错误问题
  4. 修复切换用户后，会话状态还使用的前一个用户的数据问题
  5. 修复 ELectron 平台 CMP 连接失败后未重连的问题
  6. 修复推送配置中单独设置 iOSConfig 或者 androidConfig 不生效的问题

v5.7.2​

发布日期：2023/02/07

新增功能：

  1. Electron 平台新增 batchInsertMessage 接口，支持批量插入消息到本地
  2. Electron 平台新增 getMessageCount 接口，支持获取某个会话下所有消息数量

问题修复：

  1. 修复 getConnectionStatus 接口返回状态类型错误问题
  2. 修复获取免打扰会话列表接口 getBlockedConversationList 无法返回设置了免打扰级别的会话的问题。修复后，免打扰级别（level）大于 0 的会话都会返回。

优化：

  1. Web 端本地会话状态缓存上限优化，最大支持存储 1000 条会话状态
  2. Electron 平台导航缓存优化，使用本地文件存储代替数据库存储

v5.7.1​

发布日期：2023/01/10

新增功能：

  1. Electron 平台新增 setCheckDuplicateMessage 接口，支持在接收消息时禁用消息排重机制
  2. Electron 平台 disconnect 接口增加 closeDB 参数

问题修复：

  1. 修复在火狐浏览器中的 indexDB 兼容问题
  2. 修复断网重连时调用 disconnect 无法断开连接的问题
  3. 修复调用 removeChatRoomEntry 后，其他人收到的 KV 数据更新类型（ChatroomEntryType）为 UPDATE 的问题。修复后，KV 更新类型为 DELETE。
  4. 修复 Electron 平台插入消息时设置的消息扩展字段 canIncludeExpansion，expansion 与返回数据中不一致的问题
  5. 修复 Electron 平台发起 http 请求报错的问题

优化：

  1. 补齐位置消息相关的消息类型注册
  2. IUserInfo 中增加 alias 字段

v5.7.0​

发布日期：2022/12/01

新增功能：

  1. 获取未读会话列表 getUnreadConversationList，支持单聊、群聊、系统会话。

问题修复：

  1. 修复超级群未读数计算将自己发送的超级群消息也计入的问题。
  2. 修复 ELectron 平台获取会话列表中 hasMentioned 字段错误的问题
  3. 修复 ELectron 平台获取消息中 isMentioned 字段错误的问题

优化：

  1. 断网重连时，如果被聊天室封禁，则不再尝试加入该聊天室
  2. 断网重连情况下，SDK 内部重新加入聊天室时拉取的历史消息数量为加入时传入的值，默认为 10

非兼容性变更：

  1. 连接状态监听回调参数类型变更，Events.DISCONNECT 回调参数类型由 ConnectionStatus 变更为 ErrorCode, Events.SUSPEND 回调参数类型由 ConnectionStatus | ErrorCode 变更为 ErrorCode。

  2. 部分接口类型变更

    方法名称变更前返回类型变更后返回类型
    getUltraGroupMessageListByMessageUIdIReceivedMessageIAReceivedMessage
    getConversationsFromTagByPageIReceivedConversationByTagIAReceivedConversationByTag

  3. 部分监听事件返回值类型变更

    事件名称变更前返回类型变更后返回类型事件描述
    ULTRA_GROUP_ENABLEIReceivedConversationIAReceivedConversation超级群会话列表同步完成，可以调用超级群相关接口
    ULTRA_GROUP_MESSAGE_EXPANSION_UPDATEDIReceivedMessageIAReceivedMessage超级群消息扩展更新通知
    ULTRA_GROUP_MESSAGE_MODIFIEDIReceivedMessageIAReceivedMessage超级群消息被修改通知
    ULTRA_GROUP_MESSAGE_RECALLEDIReceivedMessageIAReceivedMessage超级群消息被撤回通知

v5.6.1​

发布日期：2022/11/18

优化：

  1. 在 Electron 平台，收到撤回消息时 SDK 内部将被撤回消息更新为小灰条消息 RC:RcNtf
  2. RongIMLib.electronExtension.insertMessage 接口支持 BaseMessage 类型参数
  3. getHistoryMessagesByMessageTypes 返回对象中增加 list 字段，messages 字段标记废弃

其他：

  1. 支持京东小程序平台

v5.6.0​

发布日期：2022/11/04

新增功能：

  1. 新增接口：获取置顶会话列表

问题修复：

  1. 修复断网重连时如果 token 过期，应用层收不到状态通知的问题
  2. 修复多端登录时 ELectron 端收到消息的 offLineMessage 为 true 的问题
  3. 修复 Web 端多端登录情况下，本端未加入聊天室时，会收到其他端加入聊天室后发送的消息问题
  4. 修复 Electron 平台插入本地消息时（insertMessage），因传入的 message 中指定了服务端消息 ID（messageUId），导致消息可能重复的问题
  5. 修复 Electron 平台引用消息和图文消息无法被搜索的问题
  6. 修复 Electron 平台下发送消息无法携带 "@ 信息" 的问题
  7. 修复 Web 平台收到位置共享功能的 RC:RLQuit、 RC:RLJoin 消息时，在控制台报错的问题

非兼容性变更：

  1. 在 ELectron 平台，主进程 @rongcloud/electron 初始化时，强制要求传参 appkey，否则初始化失败，详见 主进程初始化
  2. 修改 ELectron 平台扩展 .node 包的下载方式，详见：安装 .node 文件
  3. Web 端不再支持 Comet 连接模式，仅支持 Websocket 连接

v5.5.5​

发布日期：2022/10/21

问题修复：

  1. fix: 修复导航数据变更通知向前兼容报错的问题，该问题可能导致部分使用 RTCLib 或 CallLib 的客户无法正常使用会话标签功能。

v5.5.4​

发布日期：2022/09/23

问题修复：

  1. 修复解码 RTC 信令时 int64 型数据解码错误，进而可能导致 RTC 房间内的 KV 数据异常。

v5.5.3​

发布日期：2022/09/22

问题修复：

  1. 修复网络异常时可能无 Event.SUSPEND 事件通知的问题
  2. 修复弱网情况下，可能无法收到超级群初始化完成通知 Event.ULTRA_GROUP_ENABLE 的问题
  3. 修正 Event.MESSAGES、Event.CONVERSATION 等事件的回调参数接口类型声明错误问题

v5.5.2​

发布日期：2022/09/09

新增功能：

  1. 新增接口 getUltraGroupUnreadMentionedMessages，支持获取超级群未读 @ 消息列表
  2. 新增接口 getUltraGroupFirstUnreadMessageTimestamp，支持获取超级群第一条未读消息时间戳

问题修复：

  1. 修复升级到 5.5.0 版本时，Electron 中数据库会话列表丢失的问题

v5.5.1​

发布日期：2022/09/01

新增功能：

  1. 新增接口 getTotalUnreadCountByLevels，支持按照会话的免打扰级别，获取对应会话的全部未读消息数
  2. 新增接口 getTotalUnreadMentionedCountByLevels，支持按照会话的免打扰级别，获取对应会话的全部未读 @ 消息数
  3. getUltraGroupUnreadCountByTargetId 支持按照会话的免打扰级别，获取对应会话的全部未读消息数
  4. getUltraGroupUnreadMentionedCountByTargetId，支持按照会话的免打扰级别，获取对应会话的全部未读 @ 消息数
  5. 发送、接收消息增加 messageId 字段

问题修复：

  1. 修复同时频繁修改超级群 KV 和 发送消息，可能导致接收到自己发送的消息的问题
  2. 修复在 Electron 中发送自定义消息时，content 中数字大于 32 位可能导致崩溃的问题

v5.5.0​

发布日期：2022/08/25

优化：

  1. 架构优化，降低后续 plugin-rtc 升级对 IMLib 的版本依赖

v5.4.5​

发布日期：2022/08/18

新增功能：

  1. 超级群消息修改和消息扩展中含敏感词时，在敏感词回调中通知

问题修复：

  1. 修复多端设置会话状态时会收到重复通知的问题
  2. 修复小程序平台 HTTP 请求的 header 字段错误的问题
  3. 修复加入多个聊天室时，后加入的聊天室 KV 拉取异常的问题

其他：

  1. 支持微信小程序插件平台
  2. 支付宝小程序平台支持 Websocket 连接

v5.4.4​

发布日期：2022/08/16

问题修复：

  1. 修复超级群消息扩展变更通知重复的问题。
  2. 修复超级群消息扩展变更的 channelId 为空时无通知的问题

v5.4.3​

发布日期：2022/08/04

问题修复：

  1. 修复 getUltraGroupMessageListByMessageUId 接口和超级群消息变更通知中参数 senderUserId 无值的问题。

v5.4.2​

发布日期：2022/07/21

新增功能：

  1. 新增超级群私有频道功能
  2. getUltraGroupList 接口增加 channelType 频道类型参数
  3. 新增 超级群类型（私有和公有）变更通知 RongIMLib.Events.ULTRA_GROUP_CHANNEL_TYPE_CHANGE
  4. 新增 私有频道白名单用户被移出通知 RongIMLib.Events.ULTRA_GROUP_CHANNEL_USER_KICKED
  5. 新增 删除频道通知 RongIMLib.Events.ULTRA_GROUP_CHANNEL_DLELTE

问题修复：

  1. 修复内部 logger 引用错误问题

v5.4.1​

发布日期：2022/07/02

问题修复：

  1. 修复被引用后编译时可能产生错误的问题。

v5.4.0​

发布日期：2022/07/01

新增功能：

  1. 获取会话列表增加 notificationLevel 字段
  2. init 方法增加 uploadDomain 参数，支持修改文件上传地址为指定的服务器（仅适用于私有云，暂仅支持七牛地址）
  3. 新增 Electron 平台接口：
  4. 新增黑名单相关接口

v5.3.4​

发布日期：2022/06/20

新增功能：

  1. 批量设置聊天室 KV 接口增加 isForce 字段。

问题修复：

  1. 修复频繁设置会话置顶或会话免打扰状态导致 26002 错误的问题。

v5.3.3​

发布日期：2022/06/02

新增功能：

  1. 敏感词拦截事件 Events.MESSAGE_BLOCKED 新增 extra 字段。

问题修复：

  1. 修复撤回超级群会话最后一条消息时，超级群会话中 latestMessage 字段未更新的问题。
  2. 修复可能会丢失会话类型为 ConversationType.RTC_ROOM 的直发消息的问题。
  3. 修复获取会话列表为空时，返回报错的问题。
  4. 修复收到超级群会话第一条消息时计数错误的问题。

优化：

  1. 优化撤回消息计数。

v5.3.2​

发布日期：2022/05/20

优化：

  1. 优化聊天室获取消息及扩展属性信息机制。

v5.3.1​

发布日期：2022/05/19

新增功能：

  1. 撤回消息接口增加 isDelete 参数，可控制移动端接收方是否展示撤回消息的提示小灰条。

问题修复：

  1. 优化重连逻辑，修复网络异常时可能无法重连的问题
  2. 修复 comet 连接时拉取消息报错的问题
  3. 修复免打扰级别（NotificationLevel）枚举值拼写错误，由 AT_GROUP_ALL_USER_NOFICATION 改为 AT_GROUP_ALL_USER_NOTIFICATION。
  4. 修复 App Key 未开启超级群服务时，SDK 断网重连后会异常拉取超级群消息的问题

其他：

  1. 优化连接逻辑

v5.3.0​

发布日期：2022/04/29

新增功能：

  1. 发送撤回消息的消息体中可携带 extra 字段
  2. 发送上传文件消息的接口增加 contentDisposition 参数
  3. 新增设置指定超级群默认通知配置接口 setUltraGroupDefaultNotificationLevel
  4. 新增查询指定超级群默认通知配置接口 getUltraGroupDefaultNotificationLevel
  5. 新增获取指定会话@消息未读数接口 getUnreadMentionedCount
  6. 新增获取指定超级群所有频道未读总数接口 getUltraGroupUnreadCountByTargetId
  7. 新增获取指定超级群所有频道 @ 消息未读总数接口 getUltraGroupUnreadMentionedCountByTargetId
  8. 新增获取所有超级群未读总数接口 getAllUltraGroupUnreadCount
  9. 新增获取所有超级群类型 @ 消息未读总数接口 getAllUltraGroupUnreadMentionedCount
  10. 新增设置免打扰级别接口 setConversationNotificationLevel
  11. 新增获取免打扰级别接口 getConversationNotificationLevel

问题修复：

  1. 修复收到广播消息后，断开连接再重复连接，会再次收到广播消息的问题
  2. 修复断开连接再重新连接后无法获取最新超级群会话列表的问题
  3. 修复在 IE 11 浏览器中调用 disconnect 方法报错的问题

其他:

  1. 超级群消息扩展字段 value 长度限制改为 4096

v5.2.4​

发布日期：2022/04/15

问题修复：

  1. 修复极少数情况下会丢失会话类型为 ConversationType.RTC_ROOM 的消息的问题

v5.2.3​

发布日期：2022/04/15

问题修复：

  1. 修复 https 协议时无法上报日志的问题

v5.2.2​

发布日期：2022/04/07

问题修复：

  1. 修复接受广播消息可能重复的问题。
  2. 修复获取会话列表为空时，返回报错的问题。
  3. 修复收到超级群会话第一条消息时计数错误的问题。

v5.2.1​

发布日期：2022/03/17

问题修复：

  1. 修复收到 RongIMLib.Events.ULTRA_GROUP_ENABLE 监听事件时立即调用超级群相关接口报错的问题
  2. 修复在小程序中重连失败时无法继续重连的问题
  3. 修复无法收到超级群撤回监听事件 RongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLED的问题
  4. 修复超级群中消息未读数计算不准确的问题

新增功能：

  1. 新增聊天室和 rtc 房间绑定接口 bindRTCRoomForChatroom
  2. 超级群历史消息中新增消息是否已被修改字段 isModifyMessage
  3. 监听事件 RongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLED 中增加发送者 userId 字段 senderUserId

v5.2.0​

发布日期：2022/03/02

新增功能：

  1. 新增了融云超级群会话，支持无成员上限的群组聊天
  2. 新增了超级群频道功能，可在超级群会话下创建多个频道，成员可随意在不同群频道中发送消息，但不同频道间的消息相互隔离

v5.1.2​

发布日期：2022/02/17

问题修复：

  1. 修复环境中 console 无法使用时导致 SDK 无法使用的问题 新增功能：
  2. 监听事件 DISCONNECT，SUSPEND 的回调中返回状态码
  3. 注册自定义消息时新增 'isStatusMessage' 字段

v5.1.1​

发布日期： 2022/01/17

新增功能：

  1. 为群聊已读回执功能增加 sendReadReceiptResponseMessageV2 方法，废弃 sendReadReceiptResponseMessage 方法。
  2. 增加获取免打扰会话列表接口 getBlockedConversationList

v5.1.0​

发布日期：2022/01/07

问题修复：

  1. 修复在单聊中发送 @ 消息时，接收方收到该消息时报错的问题 新增功能：
  2. IMLib 提供对 RTC 跨房间连麦功能的底层支持

v5.0.2​

发布日期：2021/12/30

问题修复：

  1. 修复会话列表中 latestMessage 为 null 时（一般在会话中最新消息在 Web 客户端本地被删除时出现）报错的问题
  2. 修复获取聊天室历史消息接口报错的问题
  3. 修复群已读回执事件中 messageUId 错误的问题。
  4. 修复 @ 消息中缺失 content.mentionedInfo.mentionedContent 字段（向客户端离线推送 @消息时可能会用到该字段）的问题
  5. 修复调用 Server API 发送消息且设置了发送者接收该消息时，如果发送方在 Web 客户端在线，会重复收到两次消息的问题。
  6. 修复重连失败时，未触发 SUSPEND 事件的问题 新增功能：
  7. 新增清除全部未读数接口
  8. 新增 MESSAGE_BLOCKED 事件，通知敏感词回调。需要联系客服开启后才能使用，默认关闭状态
  9. 新增对外 Typescript 接口：ISendImageMessageOptions, ISendFileMessageOptions

v5.0.1​

发布日期：2021/12/09

问题修复：

  1. 修复断线重连时可能收消息延迟的问题
  2. 修复连接之前多个 ping 等待造成连接延迟的问题
  3. 修复切换用户后，后登录用户使用前一用户的内存数据拉取消息的问题
  4. 修复消息体内 user.portraitUri 字段多端不一致问题，推荐使用 portrait 字段
  5. 修复单聊已读回执事件响应参数中 messageUId 错误的问题 新增功能：
  6. 新增获取未读 @ 消息数接口
  7. 新增获取所有未读 @ 消息数接口

v5.0.0​

发布日期：2021/11/16

  1. 重新定义接口实现，所有接口平铺设计，易用性更强。
  2. 新增定义发送媒体消息接口，将上传、发送过程整合，无需再集成单独的上传插件。
  3. 连接状态通知优化，将可重连、不可重连的连接中断分别提醒，便于业务区分处理。
  4. 事件监听支持多次添加，便于业务层根据不同的场景 View 监听所需事件通知。
  5. 支持批量消息通知，便于业务层针对批量数据进行业务优化，提升渲染性能。
最后于 更新