更新日志
关于停止维护 IMLib v4 旧版 SDK 的声明
注意:
- Web IMLib v4 版本目前已停止维护,建议您优先选择最新的 IMLib 版本。
- 已集成 IMLib v4 版本的用户,转为使用 Adapter 方式进行支持。集成旧版 4x SDK 的客户可以通过
RongIMLib-v4-Adapter
无缝替换升级。详见 升级说明。 - 未来我们将在
RongIMLib-v4-Adapter
上进行问题修复,但不会增加新功能。
Adapter 版本
v5.10.1
发布日期:2024/06/28
问题修复:
- 修复非群聊会话中会可能会携带 mentionedInfo 的问题
v5.9.9
发布日期:2024/06/05
问题修复:
- 修复了实时日志请求 URL 有特殊字符导致请求失败的问题。
- 修复了日志数据库升级可能会报错的问题。
v5.9.8
发布日期:2024/04/29
问题修复:
- 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。
v5.9.7
发布日期:2024/04/29
问题修复:
- 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。
v5.9.6
发布日期:2024/03/29
问题修复:
- 修复了重连报 30021 时没有重连的问题。
- 修复了主动撤回消息后,在消息监听中收到重复的撤回消息通知的问题。
v5.9.0
发布日期:2023/11/23
问题修复:
- 小程序平台不再请求动态导航地址
- 修复可能收不到敏感词拦截通知的问题
- 修复发送@消息时,会话中的@字段错误的问题
v5.8.0
发布日期:2023/07/3
问题修复:
- 修复断网重连偶现导致触发心跳问题。
v5.7.8
发布日期:2023/05/11
问题修复:
- uniapp 打包 app 链接不上
- IE 浏览器不再支持日志存储, 因为 indexDB 不支持 getAllKeys 方法
v5.7.7
发布日期:2023/04/21
问题修复:
- 修复获取免打扰列表 notificationLevel 值 undefined。
- 修复 Electron 平台获取全部会话列表无法获取系统会话的问题。
v5.7.5
发布日期:2023/04/12
问题修复:
- 优化 5.4.7 之前版本禁用资源 pb 报错。
v5.7.4
发布日期:2023/03/30
问题修复:
- 修复无法获取到未设置免打扰状态会话的未读数的问题。
- 修复在 web 平台,会收到自己设置的聊天室 kv 的通知的问题。
- 修复偶现
Cannot read property 'kvStorage' of null
的问题。 - 修复断网重连后再发消息时,偶发消息监听中收到自己发送的消息的问题。
v5.7.3
发布日期:2023/03/02
问题修复:
- 修复发送 @ 消息后发送方自己收到 @ 消息的会话变更问题
- 修复切换用户后会话状态还使用的前一个用户的数据问题
- 修复推送配置中单独设置 iOSConfig 或者 androidConfig 不生效的问题
v5.7.2
发布日期:2023/02/07
问题修复:
- 修复 getCurrentConnectionStatus 接口返回状态类型错误问题
优化:
- Web 端本地会话状态缓存上限优化,最大支持存储 1000 条会话状态
v5.7.1
发布日期:2023/01/10
问题修复:
- 修复在火狐浏览器中的 indexDB 兼容问题
- 修复断网重连时调用 disconnect 无法断开连接的问题
- 修复调用
removeChatRoomEntry
后,其他人收到的 KV 数据更新类型(ChatroomEntryType)为UPDATE
的问题。修复后,KV 更新类型为DELETE
。 - 修复 Electron 平台插入消息时设置的消息扩展字段
canIncludeExpansion
,expansion
与返回数据中不一致的问题 - 修复 Electron 平台发起 http 请求报错的问题
v5.7.0
发布日期:2022/12/01
优化:
- 断网重连时,如果被聊天室封禁,则不再尝试加入该聊天室
- 断网重连情况下,SDK 内部重新加入聊天室时拉取的历史消息数量为加入时传入的值,默认为 10
非兼容性变更:
- 连接状态监听函数变更,废弃
status
, 请使用connection
v5.6.0
发布日期:2022/11/04
问题修复:
- 修复断网重连时如果 token 过期,应用层收不到状态通知的问题
- 修复多端登录情况下,本端未加入聊天室时,会收到其他端加入聊天室后发送的消息问题
- 修复 Web 平台收到位置共享功能的
RC:RLQuit
、RC:RLJoin
消息时,在控制台报错的问题
非兼容性变更:
- Web 端不再支持 Comet 连接模式,仅支持 Websocket 连接
v5.4.5
发布日期:2022/08/18
问题修复:
- 修复用户多端登录情况下设置会话状态会导致 Web 端收到重复通知的问题
- 修复小程序平台 HTTP 请求的 header 字段错误的问题
- 修复加入多个聊天室时,后加入的聊天室 KV 拉取异常的问题
v5.3.4
发布日期:2022/06/20
问题修复:
- 修复频繁设置会话置顶或会话免打扰状态导致 26002 错误的问题。
v5.3.3
发布日期:2022/06/02
问题修复:
- 修复可能会丢失会话类型为 ConversationType.RTC_ROOM 的直发消息的问题。
- 修复获取会话列表为空时,返回报错的问题。
- 修复升级 5.0 后会话未读数无法清除的问题。
优化:
- 优化撤回消息计数。
v5.3.2
发布日期:2022/05/20
优化:
- 优化聊天室获取消息及扩展属性信息机制。
v5.3.1
发布日期:2022/05/19
问题修复:
- 优化重连逻辑,修复网络异常时可能无法重连的问题
- 修复 comet 连接时拉取消息报错的问题
- 修复 App Key 未开启超级群服务时,SDK 断网重连后会异常拉取超级群消息的问题
其他:
- 优化连接逻辑
v5.3.0
发布日期:2022/04/29
问题修复:
- 修复收到广播消息后,断开连接再重复连接,会再次收到广播消息的问题
- 修复在 IE 11 浏览器中调用 disconnect 方法报错的问题
其他:
- 发送撤回消息的消息体中可携带 extra 字段
RongIMLib 版本
4.6.3
发布日期:2022/04/15
问题修复:
- 修复极少数情况下会丢失会话类型为
ConversationType.RTC_ROOM
的消息的问题 - 修复 https 协议时无法上报日志的问题
4.6.2
发布日期:2022/04/07
问题修复:
- 修复接受广播消息可能重复的问题。
- 修复获取会话列表为空时,返回报错的问题。
4.6.1
发布日期:2022/03/17
问题修复:
- 修复在小程序中重连失败时无法继续重连的问题
4.6.0
发布日期:2022/02/17
问题修复:
- 修复在单聊中发送 @ 消息时,接收方收到该消息时可能会报错的问题
- 修复环境中 console 无法使用时导致 SDK 无法使用的问题
4.5.4
发布日期:2021/12/28
问题修复:
- 修复会话列表中 latestMessage 为 null 时(一般在会话中最新消息在 Web 客户端本地被删除时出现)报错的问题
- 修复支付宝小程序中请求导航返回值解析报错的问题
功能优化:
- 本端主动清理未读数时不再通知会话变更
新增功能:
- 新增清除全部未读数接口
4.5.3
发布日期:2021/12/09
问题修复:
- 修复断线重连时可能收消息延迟的问题
- 修复连接之前多个 ping 等待造成连接延迟的问题
- 修复切换用户后,后登录用户使用前一用户的内存数据拉取消息的问题
- 修复消息体内 user.portraitUri 字段多端不一致问题,推荐使用 portrait 字段
4.5.2
发布日期:2021/11/25
功能优化:
- 连接时优先使用缓存导航。
4.5.1
发布日期:2021/11/04
新增功能:
- 撤回消息时,会触发会话列表变更事件,开发者可在收到事件通知后刷新 UI。
问题修复:
- 修复在极少数情况下,断线重连后可能无法拉取离线消息的问题。
4.5.0
发布日期:2021/10/22
新增功能:
- 新增发送敏感词时通知功能
- 新增批量设置和删除聊天室属性能力
- 新增用户未加入聊天室时,支持获取聊天室属性信息
- 新增用户加入、退出聊天室通知能力,需要客户开通后支持,可提交工单申请开通
- 新增聊天室销毁通知能力
- 新增会话标签功能
问题修复:
- 修复加入聊天室错误时没有状态码的问题
4.4.10
发布日期:2021/10/14
问题修复:
- 修复多端同步状态消息时可能报错的问题
4.4.9
发布日期:2021/09/24
功能优化:
- 优化消息拉取功能
4.4.8
发布日期:2021/09/10
问题修复:
- 修复推送可能丢失 pushData 字段的问题
功能优化:
- 解除端上不允许发系统消息的限制
新增功能:
- 增加 Conversation.getInfo 接口
4.4.7
发布日期:2021/08/26
问题修复:
修复收到非 UpStreamMessage 的消息信令时可能报错的问题
修复在服务端发送消息时,本人可能会收到重复消息的问题
功能优化:
优化连接时返回具体错误码
增加在小程序环境请求导航
4.4.6
发布日期:2021/08/13
问题修复:
修复撤回消息时多端同步到的会话信息可能错误的问题
修复收到直发消息时清理未读数可能不能清空的问题
4.4.5
发布日期:2021/07/30
问题修复:
修复获取未读总数时未过滤免打扰会话的问题
修复单聊会话中对方可能收到 RC:SRSMsg 类型消息的问题
修复频繁删除KV时切换聊天室可能会导致不再通知KV变化的问题
新增功能:
- 增加离线消息拉取完成通知
4.4.4
发布日期:2021/07/15
问题修复:
- 修复一些情况下可能报 IDBKeyRange 错误问题
功能优化:
- 优化重连逻辑
4.4.3
发布日期:2021/07/02
问题修复:
- 修复在小程序中发送消息可能报错问题
4.4.2
发布日期:2021/07/01
问题修复:
修复日志报错问题
修复发送消息后刷新页面重新连接,可能会重复收到本端发送消息的问题
修复聊天室拉取消息时可能拉取到加入前消息的问题
修复 comet 连接重连后不发 pullMsg 问题
调用 disconnect 时清除重连定时器
4.4.1
发布日期:2021/06/11
功能优化:
- 优化 navi 存储策略
问题修复:
- 修复可能会发送多个 ping 的问题
4.4.0
发布日期:2021/06/03
新增功能:
增加 typing 消息, 新增 typing 状态通知
推送扩展新增字段
功能优化:
适配头条和百度小程序
小程序支持 comet 连接
发送消息失败时返回消息内容
重定向失败时继续重连
优化日志输出
问题修复:
- 修复监听连接状态改变为 success 时调用接口报 30001 的问题
其他
- npm 包不再支持 IE,如需支持请用 CDN 包
4.3.6
发布日期:2021/05/27
问题修复:
- 修复重新连接后未拉取离线消息问题
4.3.5
发布日期:2021/05/20
功能优化:
心跳间隔和超时改为15s
自定义 Navi 地址过滤 ’/’
禁止插件重复初始化
4.3.4
发布日期:2021/05/07
问题修复:
- 修复连接失败时不能再次调用连接的问题
- 修复在 uni-app 中,在 Android 和 iOS 平台编译不过的问题
- 修复在微信小程序中,在使用 2.16.0 及以下版本的基础调试库时报错的问题
4.3.3
发布日期:2021/04/29
问题修复:
增加内置消息类型 'RC:GIFMsg'
修复小程序无法使用 comet 连接问题
修复小程序获取导航为 null 问题
4.3.2
发布日期:2021/04/23
问题修复:
修复通知拉取消息时消息状态错误问题
修复消息的 isStatusMessage 参数判断错误问题
修复断开网络30s内重连成功时,ping 会产生多个 timer 的问题
修复多端或换端登录情况下,拉取离线补偿过程中发送消息可能导致拉取时间戳错误,导致丢失部分发件箱消息
修复发送普通群组消息后,会把会话@信息清空的问题,增加清空未读数时清空@信息
4.3.1
发布日期:2021/04/15
问题修复:
修复连接 ping 逻辑错误导致 ping 超时也不会主动中断连接
功能优化
更新日志输出格式
4.3.0
发布日期:2021/04/12
新增功能:
- 针对移动端支持了发送单条消息配置推送内容功能
- 优化了对服务器侧主动断开连接后的重连处理逻辑
- 支持新版本 Electron 桌面端解决方案 - @rongcloud/electron-solution
4.2.6
发布日期:2021/03/17
问题修复:
- 对 TypeScript 开发者增加 IAReceivedConversation 接口定义暴露
4.2.5
发布日期:2021/03/08
问题修复:
修复了加入房间时不获取历史消息,断线重连后出现聊天室消息断档问题
优化了获取单一 Conversation 会话实例时频繁拉取会话列表问题
修复了构建脚本错误导致 IMLib 文件重复打包 engine 依赖造成代码冗余问题
修复了获取历史消息时,若 timestamp 为 0、count 为 1 时无法获取数据问题
补全了 TS 开发者依赖的接口及类定义声明
4.2.4
发布日期:2021/02/24
问题修复:
- 修复了聊天室拉取消息重复问题
4.2.3
发布日期:2021/02/07
问题修复:
修复了聊天室拉取消息偶现的重复消息问题
修复了接收状态消息时更新了本地收件箱时间,导致拉取消息时可能存在消息丢失的问题
4.2.2
发布日期:2021/01/28
问题修复:
- 修复了多端情况下一端在聊天室中,另一端未加入聊天室获取聊天室消息出错的问题。
4.2.1
发布日期:2021/01/25
问题修复:
- 修复了 SDK 中部分 BUG。
4.2.0
发布日期:2021/01/20
问题修复:
修复了聊天室属性监听无法触发问题
修复了退出聊天室异常问题
修复了接收消息体里静默消息字段展示错误问题
功能优化
浏览器最低兼容到 IE 9
优化了导航连接逻辑
4.1.1
发布日期:2020/12/29
问题修复:
- 修复了群已读消息状态多端同步时,其他群成员也会收到状态同步的问题。
4.1.0
发布日期:2020/12/11
新增功能:
- 进一步优化了上传文件服务,当发送富媒体消息时如图片、文件、小视频等,上传文件失败情况下会自动切换到备份服务器进行存储,用户无感知。
问题修复:
- 修复发送的状态消息被存储、计数问题
4.0.1
发布日期:2020/11/27
问题修复:
修复了 SDK 链接导航时内部上报版本号错误的问题
补齐了小视频内置消息类型
4.0.0
发布日期:2020/11/20
新增功能:
新增了会话草稿功能
增加了对 TypeScript 的类型支持,提供 .d.ts 声明文件
功能优化:
支持了 NPM 模块集成,NPM 仓库包名为
@rongcloud/imlib-v4
提升了 SDK 代码健壮性、稳定性
提升了连接速度及连接成功率,减少不必要的网络嗅探
提升了 SDK 性能,减少不必要的异步任务
3.0.7.4 Dev
发布日期:2020/12/07
问题修复:
- 修复了加入多个聊天室后,无法退出的问题
3.0.7.3 Dev
发布日期:2020/12/07
问题修复:
- 增加了 25102 错误码提示,表示单群聊消息云存储服务未开通,无法获取服务端会话列表
3.0.7.2 Dev
发布日期:2020/11/24
问题修复:
- 修复支付宝小程序 localStorage 取值错误问题
3.0.7.1 Dev
发布日期:2020/10/14
新增功能:
- 支持了分页获取会话列表功能
3.0.7 Dev
发布日期:2020/09/18
新增功能:
针对单条消息增加了消息扩展属性设置功能,消息发送前需要设置为可扩展后,才能对该条消息进行扩展信息添加。查看文档
长轮询方式支持了会话置顶、免打扰设置功能
聊天室模块添加 reall 撤回消息方法。查看文档
问题修复:
更新了会话列表 mentionedInfo 字段存储信息,存储会话中最新 @当前用户的用户 ID
修复了长轮询方式重复连接的问题
合并转发模板 修复 Web 无展示嵌套合并转发消息问题
3.0.6 Dev
发布日期:2020/08/19
新增功能:
连接成功后,接收消息中添加该消息其他端是否已经接收过的标识字段 receivedStatus
增加了聊天室 KV 属性变化监听能力,聊天室中属性每次变化时都会同步监听状态
问题修复:
修复了 uni-app 在微信小程序下环境判断错误的问题
修复了 SDK 对部分 Emoji 特殊字符解析不正确的问题
修复了多端情况下被踢后未断开 WebSocket 连接,再次连接后重复收消息问题
修复了获取到的会话列表的会话结构中 hasMetioned 未生效的问题
功能优化:
增加了 Navi 导航请求超时时间 10 秒
增加了 CMP 超时时间 10 秒
3.0.5 Dev
发布日期:2020/07/21
新增功能:
增加了新的加入聊天室接口,如聊天室不存在则加入不成功
增加了静默消息功能,发送单条消息时支持设置该条消息没有通知
完成了对 uni-app 框架的适配,可通过 uni-app 框架实现多平台研发
问题修复:
修复了多端同步的单群聊状态消息,SDK 未向用户抛出的问题
修复了读取某会话消息时,再次接收这个会话新消息,查看此会话未读数时错误的问题
SDK 状态监听器抛出时序问题处理,防止 SDK 内部逻辑未处理完成,抛出连接成功后用户调用任意接口报错
功能优化:
- 优化了 SDK 断网重连后,自动重新加入聊天室的逻辑
3.0.4 Dev
发布日期:2020/06/19
新增功能:
增加了会话免打扰及会话置顶多端状态同步功能
增加了获取指定会话未读数方法 getUnreadCount
功能优化:
优化了上传文件服务,当发送富媒体消息时如图片、文件、小视频等,上传文件失败情况下会自动切换到备份服务器进行存储,用户无感知。
自动重连逻辑优化,防止 im.watch 重复监听 conversation、message、status 事件
3.0.3 Dev
发布日期:2020/06/02
功能优化:
- 优化了 SDK 在 FILE 协议下的连接
3.0.2 Dev
发布日期:2020/05/22
新增功能:
- IMLib SDK 增加了聊天室属性自定义存储功能,查看功能文档
3.0.1 Dev
发布日期:2020/05/07
新增功能:
实现了对音视频 SDK 3.2.2 及以上版本的兼容
增加了获取上传文件 Token 接口 getFileToken 及获取上传文件地址 Url 接口 getFileUrl
增加了获取用户 ID 接口 getConnectionUserId
增加了获取连接状态接口 getConnectionStatus
适配了微信小程序环境
问题修复:
修复了聊天室中消息方向显示不正确的问题
修复了收到撤回消息时,会话列表变化监听未执行的问题
开发者代码报错影响 SDK 消息抛出
3.0.0 Dev
发布日期:2020/03/31
新版本发布:
体积相比 SDK 2.0 减少 50%
兼容性健壮,兼容 Chrome、Firefox、Safari、IE5-11、Edge、微信浏览器、Android 2.3.6+ 等浏览器
以会话为模型的全新 API 设计,集成更便捷
内部代码高内聚低耦合,模块依赖清晰