更新日志
5.22.0
发布日期:2025/06/27
新增功能
- 新增语音消息转文字功能,可通过开发者后台自行开启。
- Electron 平台新增
searchMessageWithParams
接口,支持全局消息搜索。 - 新增
getAppSettings
接口以查询功能开关配置,目前版本仅支持查询语音转文字功能。
功能优化
- 弱化发送消息时对 needReceipt 的合法性校验,当不符合配置条件时,SDK 将强制修改为
false
,不再返回错误码阻塞消息发送。 - 新增跨会话获取消息已读人数接口
getMessageReadReceiptInfoV5ByIdentifiers
。
问题修复
- 修复 Web 端单群聊消息多端同步时,消息
targetId
值错误(受影响版本 ≥ 5.20.0) - 修复 Web 端
getMessagesReadReceiptUsersByPageV5
接口返回的 totalCount 数据错误(受影响版本 ≥ 5.20.0) - 修复 Electron 平台
MESSAGE_RECEIPT_RESPONSE_V5
事件通知中的 totalCount 数据错误(受影响版本 ≥ 5.20.0) - 修复 Web 端
getGroupApplications
接口返回数据的operationTime
取值错误(受影响版本 ≥ 5.12.0) - 修复 Web 端在未开启“会话列表支持超级群”功能的情况下,
getConversationList
返回的会话列表排序异常(受影响版本 ≥ 5.20.0) - 修复 Web 端在弱网情况下,有极低概率偶发单聊、群聊在线消息接收失败问题。
- 修复 Web 端删除会话后,接收消息重新生成的 新会话置顶、免打扰、会话标签状态丢失问题。(受影响版本 ≥ 5.20.0)
- 修复 Electron 平台搜索会话时,
messageTypes
与conversationTypes
参数未空的情况下未返回搜索结果问题(受影响版本 ≥ 5.20.0) - 其他参数校验问题修复。
5.20.2
发布日期:2025/06/12
问题修复
- 修复了 Web 端会话缓存读写错误引发的异常(受影响版本 ≥ 5.20.0)。
- 修复了 Electron 平台搜索消息、会话接口,在命中数据失败时与旧版本行为表现不一致问题(受影响版本 ≥ 5.20.0)。
- 修复了
sendMessage
调用成功后,返回的 message 数据 needReceipt 属性值错误(受影响版本 ≥ 5.20.0)。
5.20.1
发布日期:2025/06/03
新增功能
requestStreamMessageContent
接口支持微信小程序平台。
问题修复
- 修复加入聊天室后,偶现获取聊天室消息报错问题(受影响版本 ≥ 5.18.0)
5.20.0
发布日期:2025/05/31
新增功能
- 新增“会话列表支持超级群”功能,该功能需提交工单开启;开启后:
- Web 端将在内存中维护全量单群聊会话列表,并提供
Events.CONVERSATIONS_SYNCED
事件以通知业务层单群聊会话列表同步完成; getConversationList
接口返回的列表数据中将包含超级群默认频道会话;getTotalUnreadCount
返回的未读数中包含超级群默认频道会话未读数据;clearAllMessagesUnreadStatus
接口可用于删除超级群默认频道会话未读数;getTopConversationList
接口获取置顶会话列表时,将包含超级群默认频道会话;getUnreadConversationList
接口获取未读会话列表时,将包含超级群默认频道会话;
- Web 端将在内存中维护全量单群聊会话列表,并提供
removeConversation
接口支持用于删除远端超级群会话setConversationToTop
接口增加isCreateConversation
、isUpdateTime
参数支持,且支持超级群默认频道会话;clearAllMessagesUnreadStatus
新增支持 Electron 平台;- 新增
setConversationTypeNotificationLevel
、getConversationTypeNotificationLevel
接口,用于定义不同会话类型的默认免打扰等级; - 新增会话逐条消息已读功能(已读回执 v5) 功能,支持接收方对单聊、群聊会话中的消息进行已读标记,支持发送方查询消息已读状态;
getConversation
接口支持获取超级群会话;disconnect
接口支持传参disablePush
以禁用离线推送;- IMLib-v2-Adapter 回调函数支持声明为
async
异步函数; - Web 端单、群聊会话增加支持本地缓存会话首条未读消息信息;
electronExtension.searchConversationByContent
新增支持搜索指定会话类型
非兼容变更
Events.ULTRA_GROUP_ENABLE
事件将不再提供回调数据,用户可按需调用接口自行获取超级群会话列表;getBlockedConversationList
与getUnreadConversationList
接口数据变更为IAReceivedConversation[]
列表,提供更多本地缓存的会话信息(如:草稿、未读数等);- 本端发起的操作(设置会话置顶、免打扰),不再重复对本端回调
Events.CONVERSATION
事件; electronExtension.setMessageContent
接口第三个参数messageType
修改为必填参数,以支持搜索修改后的消息内容
问题修复
- 修复群组托管功能中,群组申请回调数据异常问题;
- 修复 Electron 平台偶发的连接异常问题(受影响版本 ≥ 5.16)
- 修复超级群消息发送完成后,本地会话缓存未更新问题
- 修复 Web 端收到撤回消息后,未对外通知
Events.CONVERSATION
事件问题(受影响版本 ≥ 5.18.0) - 修复对 RTCLib 的兼容性异常(受影响版本 ≥ 5.14.0)
5.18.0
发布日期:2025/05/08
重要变更
- IMLib-v4-Adapter 正式下线,
@rongcloud/imlib-v4-adapter
包最终版本将维持在 5.16.x。
新增功能
- 图片消息 content 新增
thumWidth
、thumHeight
可选值,以标注缩略图尺寸。
问题修复
- 修复了偶现接收到异常下行数据导致的报错问题(对业务无影响)。
- 修复同一用户多端同步会话置顶、免打扰数据异常。
- 修复发送 @ 消息时的参数校验错误。
- 修复 Electron 平台
setMessageStatusToRead
接口在channelId
传入非字符串数据引起的报错。 - 修复 Electron 平台好友删除通知中的 userId 列表数据错误。
- 修复 Electron 平台下,接收其他端单聊多端未读状态同步,本地未读数未清理问题(受影响版本:≥5.16.0)。
- 修复业务通过调用 Server API 接口设置聊天室 KV 属性后,Electron 平台下业务层接收到两次回调问题。
5.16.1
发布日期:2025/04/10
问题修复
- 修复了 Electron 平台下,IMLib 多端已读状态同步导致对端未读数被清空问题(受影响版本:5.16.0)。
5.16.0
发布日期:2025/03/28
新增功能
- 新增了
"RC:StreamMsg"
流式消息功能,新增requestStreamMessageContent
方法以拉取流消息内容数据(不支持小程序)。 - IM 连接支持纯 IPv6 协议。
- 用户信息托管增加用户资料审核,更新数据时若审核失败增加返回失败字段列表。
- 撤回消息新增
isAdmin
参数支持,以满足 IMKit 显示需求。 - 新增
electronExtension.getLocalMessage
接口,原getMessage
接口废弃。
问题修复
- 修复超级群消息撤回时,撤回接口返回的数据与撤回单群聊消息结果不一致问题,消除接口二义性
- 修复 Electron 平台下
getMessage
接口获取本地消息时,数据查询失败仍然后ErrorCode.SUCCESS
问题;当前修改为返回ErrorCode.RC_DB_DATA_NOT_FOUND
。 - 修复将群信息、用户信息字段设置为
""
或0
后,相应群信息变 更通知缺少变更字段问题。 - 修复 Electorn 平台日志写库错误,导致日志内容丢失问题(受影响版本:≥5.12.2)
- 修复 Electron 平台下日志上报偶现遗漏、重复问题
- 修复 Web 断网情况下,调用发送消息接口后 onSendBefore 回调不执行问题
5.14.1
发布日期:2025/03/06
问题修复
- 修复
@rongcloud/engine
包部分定义未导出,导致 RTC、Call、CallPluls 等业务 SDK 异常;影响版本 5.14.0。 - 修复连续快速调用退出、加入聊天室时,偶现进入房间后未拉取 KV 数据的问题。
5.14.0
发布日期:2025/02/28
新增功能:
- Web 端会话列表增加支持
operationTime
字段,用于记录会话操作时间。 Events.GROUP_INFO_CHANGED
事件回调中增加fullGroupInfo
数据以提供全量群组信息。- 增加设置、查询全局免打扰配置功能。
问题修复
- 修复 ELectron 平台下 tag 变更未回调通知的问题。
- 修复配置异常可能引发客户端无法接收好友邀请等推送通知问题。
- 修复 Electron 单进程模式下运行时,发送消息无法接收到
onBefore
回调问题。 - 修复 Electron 平台下,
getChatroomEntry
接口响应码与 Web 平台不一致的问题。
重要变更
- 各接口响应错误码类型修改为
number
。
5.12.4
发布日期:2025/02/06
问题修复:
- 修复了接收消息后未更新本地会话未读数的问题,以及其他缓存错误问题(5.12.3 版本引入)。
v5.12.3
发布日期:2025/01/17
问题修复:
- 修复了 Electron 平台设置会话置顶时,导致免打扰级别变更的问题。
- 修复了
searchGroupMembers
接口返回结果格式错误的问题,返回结果中增加pageToken
字段。
v5.12.2
发布日期:2024/12/26
新增功能:
- 新增了单群聊消息是否更新会话列表中最后一条消息开关。
功能优化:
- 修复了聊天室中被封禁后,断网重连后会重新加入的问题。
- 修复了子进程重启后已注册的自定义消息丢失的问题。
- 修复了子进程崩溃重连失败后无法继续重连的问题。
- 修复了 Electron 平台 callInfo 监听返回的数据结构错误的问题。
- 优化了 Electron 日志上报数据格式。
- 优化了多端同步阅读状态接口增加定向消息回话类型过滤。
v5.12.1
发布日期:2024/10/28
功能优化:
- 修复了子进程崩溃重启时 token 或 navi 过期会导致无法重连的问题。
- 当传递的参数
count
出错的时候,getFriends
和getFriendApplications
接口返回的错误码从 34328 改为 34232。 - 修复了子进程启动
updateGroupInfo
接口扩展字段默认值无法赋值的问题。
v5.12.0
发布日期:2024/10/18
新增功能:
- 信息托管服务中新增群组及成员管理能力。
- 信息托管服务中新增好友关系管理能力。
功能优化:
- 修复 Web 端 未开启用户状态订阅,仅开启用户信息托管 时,获取用户资料报错的问题。
- 修复插入消息后,消息 content 为空的问题。
v5.10.4
发布日期:2024/08/29
功能优化:
- 适配在 uniapp 平台使用 Vue3 框架编译为 APP 端时的兼容问题。
- Electron 平台增加数据库升级回调事件。
v5.10.3
发布日期:2024/07/30
新增功能:
- 加入聊天室的接口返回中增了加入时间。
- 发送消息支持设置 HarmonyOS 推送属性。
- 在线状态订阅支持了 HarmonyOS 平台。
问题修复:
- 修复了发送图片消息的缩略图有黑边的问题。
v5.10.2
发布日期:2024/07/02
功能优化:
- 修改置顶空会话同步功能默认为 false。
v5.10.1
发布日期:2024/06/28
新增功能:
- 新增用户信息托管功能
- Electron 平台支持关闭置顶空会话同步
问题修复:
- 修复 searchMessages 接口返回 count 可能为 undefined 的问题
- 修复非群聊会话中会可能会携带 mentionedInfo 的问题
- 修复发送 RC:SRSMsg 时,Content 中的 lastMessageSendTime 字段传错的问题
v5.9.9
发布日期:2024/06/05
新增功能:
- Electron 平台新增了
批量获取会话信息
方法。
问题修复:
- 修复了实时日志请求 URL 有特殊字符导致请求失败的问题。
- 修复了不能给系统会话发送 RC:SRSMsg 消息的问题。
- 修复了日志数据库升级可能会报错的问题。
- 修复了 Electron 本地插入 RC:RcNtf 消息的发送状态异常的问题。
- 修复了在 Electron 平台,RTC 信令发送和解析失败的问题。
- 修复了连接时连续收到多个 30021 导致子进程崩溃的问题。
- 修复了批量插入消息 LastMessage 更新问题。
- 修复了应用退出,子进程会重启的问题。
v5.9.8
发布日期:2024/04/29
新增功能:
- 新增了在线状态订阅功能。
- 新增了撤回消息支持发送定向通知的能力。
- Electron 平台新增了
获取本地指定时间戳前后 N 条消息
方法。 - Electron 平台
搜索本地指定会话历史消息接口
支持传入消息类型。
问题修复:
- 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。
- 修复了导出 CombineV2Message 错误。
v5.9.7
发布日期:2024/04/01
问题修复:
- 修复了使用 NPM 下载 IMLib-next 包时报错的问题。
v5.9.6
发布日期:2024/03/29
新增功能:
- 定向消息中增加了指定接收消息的目标用户列表。
- 引用消息中增加了被引用的唯一标识
referMsgUid
。 - 新增了
electronExtension.getContinuousMessages
接口,用以同时查询本地与远端历史消息。
问题修复:
- 修复了重连报 30021 时没有重连的问题。
- 修复了主动撤回消息后,在消息监听中收到重复的撤回消息通知的问题。
优化功能:
- 适配 Electron 平台开启上下文隔离场景。
v5.9.5
发布日期:2024/01/31
优化功能:
- 消息数据中的
receivedStatusInfo
改为可选,解决 TS 开发中可能存在的报错。
v5.9.4
发布日期:2024/01/31
新增功能:
- 超级群支持发送定向消息功能
- 超级群支持按消息 Uid 批量删除消息
- 空会话置顶支持多端同步
- 获取会话列表功能增加参数是否按置顶状态排序
- Electron 平台新增获取全部 @ 消息未读数接口
- Electron 平台新增发送状态消息功能
问题修复:
- 修复发送图片消息时,缩略图质量参数 quality 无效的问题
- 修复 Electron 平台发送状态消息异常问题
优化功能:
- 优化群消息已读回执功能
v5.9.3
发布日期:2023/12/18
新增功能:
- Electron 平台新增 setMessageReceivedStatusInfo 方法
优化功能:
- 单聊已读回执回调参数中增加 sendUserId 用于判断是自己还是对方发的
- 优化多设备登录收取离线消息时消息回执监听触发早于消息监听
问题修复:
- 修复 removeChatRoomEntries 接口参数 ts 类型定义错误
- 修复会话状态变更通知里的时间不对的问题
v5.9.2
发布日期:2023/12/13
问题修复:
- 修复 Electron 在 Windows 平台发送消息接口响应延迟高的问题
- 修复 Electron 在 Windows 平台拉大量离线消息时应用卡顿的问题
- 接口
addConversationsToTag
增加限制,会话列表不能为空
v5.9.1
发布日期:2023/11/28
问题修复:
- 修复 Node 14 以下版本无法下载 @rongcloud/electron 依赖包的问题
v5.9.0
发布日期:2023/11/23
新增功能:
- 消息拓展变更通知(Events.EXPANSION)回调数据
IExpansionListenerData
中补充会话信息。从 5.9.0 开始,IUpdatedExpansion 与 IDeletedExpansion 均返回conversationType
和targetId
。 - 聊天室成员加入、退出通知 (Events.CHATROOM) 回调 IChatroomUserChangeInfo 中增加当前聊天室人数
memberCount
。 - 新增
getAllUnreadMentionedCount
接口,支持获取所有会话类型的未读 @ 消息数。 - 获取会话列表接口返回的会话数据
IAReceivedConversation
中增加草稿字 段 draft。 - 新增
getFirstUnreadMessageInfo
接口,支持获取第一条未读消息信息。 - 支持荣耀推送配置,可在发送消息时通过
IPushConfig
下的 IAndroidPushConfig 控制荣耀推送的消息提醒级别与通知栏图片。
问题修复:
- 小程序平台不再请求动态导航地址
- 修复可能收不到敏感词拦截通知的问题
- 修复发送@消息时,会话中的@字段错误的问题
- 修复高频调用 tag 和会话状态相关接口时报 26002 的问题
- Electron 平台修复发送撤回消息后,再次拉到撤回消息时原始消息被修改两次的问题
- 修复 Electron 的 Windows 平台退出时卡死的问题
- 优化消息量大时,在 Windows 平台会导致应用卡顿问题
v5.8.5
发布日期:2023/10/27
优化功能:
- 优化 SDK 日志上传机制
问题修复:
- 修复发送 @ 消息时,会话中的 @ 字段错误的问题
v5.8.4
发布日期:2023/09/25
新增功能:
- Electron 平台支持免打扰级别功能
- 会话列表中增加 operationTime 字段(仅 Electron 平台支持)
问题修复:
- 修复加入聊天室后,刷新页面并连接后会自动重新加入的问题
- 修复插入本地的撤回消息已读状态错误的问题(Electron 平台)
- 修复并发上传语音消息时报错的问题
v5.8.3
发布日期:2023/08/31
新增功能:
- 多端同步会话未读数功能支持系统会话。
- 发送文件消息(上传)支持携带 @ 信息。
- 加入聊天室接口返回房间信息与用户状态信息,例如是否禁言、是否在禁言白名单中、聊天室人数等。
- 在 Electron 平台,如果消息被撤回时本地数据库已不存在该消息,仍然插入一条 RC:RCNtf 类型消息。
v5.8.2
发布日期:2023/07/28
新增功能:
- Electron 平台支持 win32 X64 架构
- Electron 平台增加处理多端同步消息 RC:ReadNtf
- Electron 平台适配上传功能
问题修复:
- 修复服务器重启后可能导致连接不成功的问题
- 修复支付宝小程序连接报错问题
v5.8.1
发布日期:2023/07/14
新增功能:
- 新增小灰条消息(RC:InfoNtf)、命令消息(RC:CmdMsg)、群组通知消息(RC:GrpNtf)的发送
v5.8.0
发布日期:2023/07/3
新增功能:
- 超级群查询未读 @ 消息增加返回消息类型属性
问题修复:
- 修复断网重连偶现导致触发心跳问题。
其他:
- 小程序平台安全域名调整:安全域名
v5.7.10
发布日期:2023/06/15
新增功能:
- 新增接口
getUltraGroupUnreadInfoList
, 支持批量获取超级群会话未读信息 - Electron 平台新增接口
searchMessagesByUser
, 支持根据发送者ID 搜索本地单群聊会话消息
问题修复:
- 修复撤回超级群 @ 消息时,未读 @ 数减一异常的问题。
- 修复拉取超级群消息可能陷入死循环的问题。
v5.7.9
发布日期:2023/05/29
新增功能:
- 新增聊天室状态通知(封禁、禁言、加入/退出多端状态同步)
- Electron 平台增加在收到 30019、30021 状态码时 SDK 会自动发起重连逻辑
- 初始化增加区域码设置
- 超级群获取频道列表接口增加 @ 我的未读消息数属性
问题修复:
- 修复超级群收到撤回消息时,未读消息数异常问题
- 修复支付宝小程序平台重新连接时会建立两个 socket 连接的问题
v5.7.8
发布日期:2023/05/11
新增功能:
- IMLib 的 Electron平台增加对草稿的操作
问题修复:
- uniapp 打包 app 链接不上
- IE 浏览器不再支持日志存储, 因为 indexDB 不支持 getAllKeys 方法
v5.7.7
发布日期:2023/04/21
问题修复:
- 修复获取免打扰列表 notificationLevel 值 undefined。
- 修复 Electron 平台获取全部会话列表无法获取系统会话的问题。
其他:
- 增加处理多端同步 RC:ReadNtf 消息逻辑。
- 消息推送属型配置 IPushConfig.androidConfig 新增
categoryVivo
字段。如果指定了categoryVivo
,必须同时指定匹配的typeVivo
。该字段优先级高于控制台为 App Key 下的应用标识配置的 vivo 推送 Category。categoryVivo
字段对应 vivo 推送服务的消息二级分类(category
字段)。详细取值请参见 vivo 推送消息分类说明。typeVivo
字段对应 vivo 推送服务的消息分类(classification
字段,区分系统消息、运营消息)。请注意遵照 VIVO 官方要求,确保二级分类(category
)取值属于classification