更新日志
5.42.1
发布日期:2026/07/17
问题修复
- 修复开启消息审核服务后,偶现通过 Server API 以用户 A 的身份发送消息时,用户 A 登录的 Web 端未能正确接收该消息的问题(影响版本:5.14.0 - 5.42.0)。
5.42.0
发布日期:2026/06/30
新增功能
- 增加消息表情回应功能接口和相关通知事件。
功能优化
- Web 端接收未注册类型的消息数据时,
isCounted与isPersited以服务器下发数据为准,以确保 SDK 缓存会话列表和未读计数准确。
5.40.0
发布日期:2026/06/01
新增功能
AppSettings新增messageSizeLimit属性,用于查询当前应用的消息体大小限制。自 2026/05/29 起,新注册客户的除图片消息(
RC:ImgMsg)、流式消息(RC:StreamMsg)、语音消息(RC:VcMsg)、视频消息(RC:SightMsg)、位置消息(RC:LBSMsg)、合并转发消息(RC:CombineV2Msg,RC:CombineMsg)、引用消息(RC:ReferenceMsg)外,其他消息的content消息体大小限制不超过 10 KB。实际上限以messageSizeLimit返回值为准。以下类型消息的消息体大小上限仍为 128 KB:
- 图片消息(
RC:ImgMsg) - 流式消息(
RC:StreamMsg) - 语音消息(
RC:VcMsg) - 视频消息(
RC:SightMsg) - 位置消息(
RC:LBSMsg) - 合并转发消息 v2(
RC:CombineV2Msg) - 合并转发消息(
RC:CombineMsg) - 引用消息(
RC:ReferenceMsg)
- 图片消息(
- 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)。
5.28.1
发布日期:2025/10/10
新增功能
- Electron 平台增加支持消息的
isModifyMessage属性。
问题修复
- 修复 Web 端获取历史消息接口返回的数据排序异常、数据异常(受影响版本 5.28.0)。
5.28.0
发布日期:2025/09/26
非兼容修改
- 原
getUnreadMentionedMessages接口为同步阻塞接口,在 Electron 平台存在性能问题,因此该接口已废弃并失效。SDK 新增electronExtension.getUnreadMentionedMessages异步接口,以替代被废弃的接口。
新增功能
- Electron 平台新增支持超级群会话类型。
- 聊天室功能优化,Electron 平台功能补齐,非 Electron 平台内部逻辑优化,并修复部分已知问题。
getBlockedConversationList接口新增支持 Electron 平台。- Electron 平台新增
Events.DATABASE_OPENED事件,用于监控本地数据库正常打开或数据库文件损坏后重建事件。 - 新增
getUnreadMentionMeConversationList接口,用于获取未读的包含 @ 消息的会话列表。 - 新增
getSubscribeUsersOnlineStatus接口,用于查询已订阅用户的在线状态。
功能优化
- 优化了 Electron 平台接收大量消息扩展时的写库效率,提升相关场景性能。
- 新增了
getConversationListByTimestamp与getAllConversationList接口,用于替换getConversationList接口,以避免原接口在不同平台、入参情况下的结果差异性问题。
问题修复
- 修复了 Web 端
updateMyUserProfile更新本人信息后,本地缓存未更新的问题(受影响版本 ≥ 5.24.0)。 - 修复了 Web 端会话的
latestMessage属性中的targetId赋值异常问题(受影响版本 ≥ 5.20.0)。 - 修复了 Electron 平台
getRemoteHistoryMessages返回列表顺序 错误的问题,与其他端保持一致。 - 修复了 Electron 平台
requestSpeechToTextForMessage接口偶现响应延迟问题(受影响版本 ≥ 5.22.0)。
5.26.2
发布日期:2025/09/11
新增功能
- Electron 平台新增了支持同步服务器端会话列表的能力。
removeConversation接口增加支持 Electron 平台下删除服务器端会话能力。
问题修复
- 修复了 Electron 平台日志模块极端情况下偶现的内存泄露问题(受影响版本为 5.26.0 和 5.26.1)。
5.26.1
发布日期:2025/09/05
新增功能
- 支持了对单聊、群聊已发送成功的消息进行消息编辑。
- 优化了 Web 端获取会话列表功能,会话数据中增加
latestMessage数据。涉及:- 获取置顶会话列表:
getTopConversationList - 获取免打扰会话列表:
getBlockedConversationList - 获取未读列表:
getUnreadConversationList - 获取 tag 下的会话列表:
getConversationsFromTagByPage - 获取指定会话:
getConversation
- 获取置顶会话列表:
- 提供批量会话删除接口
batchDeleteConversations。 - 废弃 Electron 平台多进程模式,保持主进程单进程运行,并优化单进程模式下的消息处理性能。
问题修复
- 修复了 Web 端可能存在 RTC 业务消息及敏感词拦截通知消息被丢弃的问题。
- 修 复了 Web 端接收异常消息(content 内容为 "null")时导致的业务异常。
- 修复抖音小程序平台下,应用退至后台再重新进入前台时无法恢复连接问题。
- 优化错误入参导致的 Electron 平台运行崩溃问题。
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)。