更新日志
5.40.0
发布日期:2026/06/01
新增功能
AppSettings新增messageSizeLimit属性,用于查询当前应用的消息体大小限制。自 2026/05/29 起,新注册客户的文本消息(
RC:TxtMsg)和自定义消息默认消息体大小上限为 5 KB;存量客户默认仍为 128 KB。实际上限以messageSizeLimit返回值为准。以下类型消息的消息体大小上限仍为 128 KB:
- 语音消息(
RC:VcMsg) - 图片消息(
RC:ImgMsg) - 引用消息(
RC:ReferenceMsg) - 流式消息(
RC:StreamMsg) - 合并转发消息(
RC:CombineMsg) - 合并转发消息 v2(
RC:CombineV2Msg) - 小视频消息(
RC:SightMsg)
- 语音消息(
- Electron 平台增加渲染进程与主进程 SDK 一致性验证,版本不一致时渲染进程 SDK 将初始化失败。
问题修复
- 修复 Web 平台会话数据中
hasMentioned偶现异常的问题。 - 调整 Web 端会话
mentionedInfo的更新逻辑。当会话中存在多条 @ 我或 @ 所有人未读消息时,SDK 保留最新一条相关未读消息的mentionedInfo数据。
5.38.0
发布日期:2026/05/18
新增功能
- 发送消息新增
quoteInfo属性,用于描述和其他消息的引用关系。 - 新增
getMessagesByUIds接口,可通过消息 UID 批量查询消息数据。
问题修复
- 修复多端同步发件箱消息偶现通知延迟问题(影响版本:5.14.0 - 5.38.0)。
- 修复开启"服务器记录会话未读数"功能后,离线
RC:SRSMsg消息处理异常导致的未读计数错误(影响版本:5.36.0 - 5.38.0)。 - 修复群内 @ 指定成员的消息,非指定成员接收消息
isMentioned值为false问题。
5.36.7
发布日期:2026/04/23
新增功能
Events.CHATROOM事件数据中新增chatroomDestroyedType属性。
问题修复
- 修复流式消息在下行传输过程中异常超时中断的问题(影响版本:5.16.0 - 5.36.6)。
- 修复用户被封禁 并被移出聊天室后,无法收到解禁通知的问题(影响版本:5.34.0 - 5.36.6)。
5.36.6
发布日期:2026/03/30
问题修复
- 修复 Electron 平台在开启服务器记录会话未读数功能的情况下,偶发客户端计数错误问题。(影响版本:5.34.0 - 5.36.6)
- 修复 Web 端接收群聊 @ 消息时未读数计数错误。(影响版本:5.34.0 - 5.36.6)
5.36.5
发布日期:2026/03/23
问题修复
- 修复
getUltraGroupList接口未传参数的情况下报错问题。(影响版本:5.28.0 - 5.36.4)
5.36.4
发布日期:2026/03/18
问题修复
- 修复部分会话列表获取接口在数量超出 100 时偶现返回 25108 错误码的问题。(影响版本:5.26.0 - 5.36.3)
涉及接口:
getTopConversationListgetBlockedConversationListgetUnreadConversationListgetConversationsFromTagByPage
5.36.3
发布日期:2026/03/13
问题修复
- 修复 Web 端未接收到他人回复的单聊已读回执问题(影响版本:5.34.0 - 5.36.2)
5.36.2
发布日期:2026/03/05
问题修复
- 修复 Web 端撤回非本人发送的消息导致对方未读数计数异常问题,并修复计数可能出现负数问题。
- 修复 Web 端偶发超级群消息撤回通知异常问题(影响版本:5.28.0 - 5.36.1)。
- 发送 @ 消息时取消目标会话类型检查,允许向除群组、超级群之外的其他会话类型发送 @ 消息(影响版本:5.32.0 - 5.36.1)。
5.36.1
发布日期:2026/02/03
功能优化
-
优化 Web 端与小程序平台的会话状态数据存储策略,以减少对 LocalStorage 空间的占用。
注意- 该优化仅针对会话数量较大的用户场景(会话数量超出 2000)提供,开启该功能需提交工单。
- 功能开启后,会增加下行消息量,以及用户连接后的会话状态同步等待时长,因此不建议普通场景用户开启此功能。
问题修复
- 修复 Uniapp 和各类小程序平台初始化异常(影响版本:5.36.0)。
5.36.0
发布日期:2026/01/30
新增功能
- Web 端
Events.CONVERSATION事件通知中增加unreadMentionedCount和unreadMentionedMeCount数据通知。 - Electron 平台返回的会话数据中新增
dataMgmtInfo属性,包含会话名称和头像信息,用于会话列表中快捷显示用户和群组托管信息。
功能优化
- 优化 Electron 集成体验:
- 开发者不再需要调用
initRenderer与initContextBridge函数。 - 支持开发者在开启 Electron 上下文隔离开关的情况下,加载非工程化的页面。
- 开发者不再需要调用
问题修复
- 修复多端消息补偿功能未开启的情况下,Web 端偶现丢消息问题(影响版本:5.20.0 - 5.34.0)。
- 修复开启审核服务的情况下,Web 端偶现多端同步消息接收延迟问题(影响版本:5.20.0 - 5.34.0)。
- 修复群已读回执 v1 中,获取群内历史消息的
readReceiptInfo数据异常(影响版本:5.34.0)。
5.34.0
发布日期:2025/12/26
功能优化
- Electron 平台新增支持搜索
setMessageContent修改后的消息。 - 优化各小程序平台的缓存读写性能,避免线程阻塞。
问题修复
- 兼容 UniApp 框架编译打包鸿蒙原生 App 场景,修复断线重连异常。
- 修复 Electron 平台单聊会话调用
sendSyncReadStatusMessage失败问题(影响版本 :5.32.0)。 - 修复 Electron 平台
disconnect后,渲染进程内存登录态未及时清理导致的异常(影响版本:5.7.0 - 5.32.0)。 - 修复 Electron 平台
getRemoteHistoryMessages接口order为 0 时返回数据排序错误(影响版本:5.28.0 - 5.32.0)。 - 修复偶现会话状态同步数据版本缓存错误引发的异常(影响版本:5.20.0 - 5.32.0)。
5.32.0
发布日期:2025/11/28
新增功能
- 优化了单、群聊消息撤回功能,解决 Web 端获取会话历史消息时
RC:RcCmd撤回消息与实际被撤回消息位置不一致的问题。为保持向前兼容,该优化目前需联系融云客服手动开启。 - 新增了机器人信息托管功能,支持获取机器人列表和机器人信息。
- Web 端新增了
createConversationListLoader接口,用于从服务器直接查询标签下的分页会话,解决客户端本地查询接口分页异常问题。
问题修复
- 修复了 Web 端偶现的下行数据解析失败引发的异常。
- 修复了 Web 端
getFriendAddPermission接口返回值与接口类型声明不匹配的问题。 - 修复了 Web 端主动撤回消息时,本地会话未读数计数错误减 1 的问题。(受影响版本:5.20.0 - 5.30.2)
- 修复了 Web 端
removeTagFromConversations与removeConversationsFromTag接口异常。(受影响版本:5.24.0 - 5.30.2) - 修复了 Electron 平台接收群已读回执消息时,本地数据库更新错误的问题。(受影响版本:5.26.0 - 5.30.2)
- 修复了 Electron 平台下
RC:RcCmd撤回消息存储错误,导 致获取历史消息时仍能获取到该类型消息的问题。(受影响版本:5.20.0 - 5.30.2)
5.30.1
发布日期:2025/11/14
新增功能
- 退出聊天室接口增加支持透传
extra信息。
5.30.0
发布日期:2025/10/31
功能优化
- 优化 Web 端
refreshReferenceMessageWithParams接口响应数据,补全引用消息content.referMsgStatus状态数据。 - 优化断网情况下
getUserProfiles接口响应,支持返回本地缓存数据。 - 优化
getConversationsFromTagByPage接口,支持最大获取 1000 条会话,以解决 Web 端可能存在的分页异常问题。 - 优化 Web 端事件补偿逻辑,补全断线重连期间的事件通知,涉及逐条消息已读回执(V5)等功能。
问题修复
- 修复 Web 端登录账号切换时,偶现 SDK 内部报错的问题。
- 修复 APIDoc 及部分
.d.ts声明文件未正确导出的问题。 - 修复 Web 端无法接收到敏感词屏蔽通知的问题(受影响版本:5.26.1 - 5.28.1)。
- 修复 Web 端偶现
Events.CONVERSATION事件未通知变更time数据的问题(受影响版本:5.20.0 - 5.28.1)。 - 修复 Web 端接收超级群消息时偶现未读数计数错误的问题(受影响版本:5.20.0 - 5.28.1)。