更新日志
5.24.2
发布日期:2025/08/14
新增功能
- 新增了对快手小程序平台的支持。
问题修复
- 修复了 Web 平台偶现会话缓存读取失败导致的业务异常。(受响应版本: 5.24.0 和 5.24.1 )
- 修复了 Electron 平台偶现消息断档引起的过量冗余数据拉取的问题。
- 修复了 Electron 平台获取会话(或会话列表)接口偶现的会话的
translateStrategy
属性值异常的问题。 - 修复了 Electron 平台偶现的获取好友扩展信息数据丢失的问题。
5.24.1
发布日期:2025/08/04
问题修复
- 修复了偶现翻译功能开关开启时,调用翻译接口无法收到翻译结果事件通知问题。
- 修复了 Web 接收聊天室销毁通知后,本地缓存清理异常导致的问题。
- 修复了 Electron 平台
getConversation
接口返回值中translateStrategy
数据错误的问题。
5.24.0
发布日期:2025/07/25
新增功能
- 新增了消息文本翻译功能,可翻译文本消息和任意文本。
- 新增了会话状态同步完成通知
Events.CONVERSATIONS_SETTINGS_SYNCE
。 - 新增了用户级配置同步完成通知
Events.USER_SETTINGS_SYNCED
。 - 新增了用户级配置变更通知
Events.USER_SETTINGS_CHANGE
。 - 在
AppSettings
配置查询中增加了isConversationListIncludeUltraGroup
配置项属性,以查询是否开启“会话列表支持超级群”的功能。 - 新增了
electronExtension.getUntaggedConversationListByPage
接口以获取未打标记的会话列表。
问题修复
- 修复了偶现 Web 端
getConversationsFromTagByPage
返回的会话列表数据operationTime
为 0 的问题(受影响版本 ≥ 5.20.0)。 - 修复了 Web 端在线收消息时,消息 expantion 拓展数据未解析的问题(受影响版本 ≥ 5.20.0)。
- 修复 Electron 平台偶现 PC 设备休眠后唤醒,连接无法恢复的问题(错误码 32061)。
- 修复了 V2-Adapter 对老版本上传插件的兼容性问题。
- 修复了 Electron 平台
clearHistoryMessages
入参缺少channelId
时删除失败问题(受影响版本 ≥ 5.20.0)。 - 修复了 Web 端调用
setConversationTypeNotificationLevel
接口后,本地缓存数据更新异常的问题。
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