文档导航
Web
SDK 版本:  4.X
您当前查看的是 4.X 版本 SDK 文档。如需查看最新 5.X SDK 文档,可在右侧进行切换。

更新日志

更新时间:2024-06-24 PDF

关于停止维护 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

问题修复:

  1. 修复非群聊会话中会可能会携带 mentionedInfo 的问题

v5.9.9

发布日期:2024/06/05

问题修复:

  1. 修复了实时日志请求 URL 有特殊字符导致请求失败的问题。
  2. 修复了日志数据库升级可能会报错的问题。

v5.9.8

发布日期:2024/04/29

问题修复:

  1. 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。

v5.9.7

发布日期:2024/04/29

问题修复:

  1. 修复了 Web 端拉取消息后处理异常时导致不再拉取消息的问题。

v5.9.6

发布日期:2024/03/29

问题修复:

  1. 修复了重连报 30021 时没有重连的问题。
  2. 修复了主动撤回消息后,在消息监听中收到重复的撤回消息通知的问题。

v5.9.0

发布日期:2023/11/23

问题修复:

  1. 小程序平台不再请求动态导航地址
  2. 修复可能收不到敏感词拦截通知的问题
  3. 修复发送@消息时,会话中的@字段错误的问题

v5.8.0

发布日期:2023/07/3

问题修复:

  1. 修复断网重连偶现导致触发心跳问题。

v5.7.8

发布日期:2023/05/11

问题修复:

  1. uniapp 打包 app 链接不上
  2. IE 浏览器不再支持日志存储, 因为 indexDB 不支持 getAllKeys 方法

v5.7.7

发布日期:2023/04/21

问题修复:

  1. 修复获取免打扰列表 notificationLevel 值 undefined。
  2. 修复 Electron 平台获取全部会话列表无法获取系统会话的问题。

v5.7.5

发布日期:2023/04/12

问题修复:

  1. 优化 5.4.7 之前版本禁用资源 pb 报错。

v5.7.4

发布日期:2023/03/30

问题修复:

  1. 修复无法获取到未设置免打扰状态会话的未读数的问题。
  2. 修复在 web 平台,会收到自己设置的聊天室 kv 的通知的问题。
  3. 修复偶现 Cannot read property 'kvStorage' of null 的问题。
  4. 修复断网重连后再发消息时,偶发消息监听中收到自己发送的消息的问题。

v5.7.3

发布日期:2023/03/02

问题修复:

  1. 修复发送 @ 消息后发送方自己收到 @ 消息的会话变更问题
  2. 修复切换用户后会话状态还使用的前一个用户的数据问题
  3. 修复推送配置中单独设置 iOSConfig 或者 androidConfig 不生效的问题

v5.7.2

发布日期:2023/02/07

问题修复:

  1. 修复 getCurrentConnectionStatus 接口返回状态类型错误问题

优化:

  1. Web 端本地会话状态缓存上限优化,最大支持存储 1000 条会话状态

v5.7.1

发布日期:2023/01/10

问题修复:

  1. 修复在火狐浏览器中的 indexDB 兼容问题
  2. 修复断网重连时调用 disconnect 无法断开连接的问题
  3. 修复调用 removeChatRoomEntry 后,其他人收到的 KV 数据更新类型(ChatroomEntryType)为 UPDATE 的问题。修复后,KV 更新类型为 DELETE
  4. 修复 Electron 平台插入消息时设置的消息扩展字段 canIncludeExpansionexpansion 与返回数据中不一致的问题
  5. 修复 Electron 平台发起 http 请求报错的问题

v5.7.0

发布日期:2022/12/01

优化:

  1. 断网重连时,如果被聊天室封禁,则不再尝试加入该聊天室
  2. 断网重连情况下,SDK 内部重新加入聊天室时拉取的历史消息数量为加入时传入的值,默认为 10

非兼容性变更:

  1. 连接状态监听函数变更,废弃 status, 请使用 connection

v5.6.0

发布日期:2022/11/04

问题修复:

  1. 修复断网重连时如果 token 过期,应用层收不到状态通知的问题
  2. 修复多端登录情况下,本端未加入聊天室时,会收到其他端加入聊天室后发送的消息问题
  3. 修复 Web 平台收到位置共享功能的 RC:RLQuitRC:RLJoin 消息时,在控制台报错的问题

非兼容性变更:

  1. Web 端不再支持 Comet 连接模式,仅支持 Websocket 连接

v5.4.5

发布日期:2022/08/18

问题修复:

  1. 修复用户多端登录情况下设置会话状态会导致 Web 端收到重复通知的问题
  2. 修复小程序平台 HTTP 请求的 header 字段错误的问题
  3. 修复加入多个聊天室时,后加入的聊天室 KV 拉取异常的问题

v5.3.4

发布日期:2022/06/20

问题修复:

  1. 修复频繁设置会话置顶或会话免打扰状态导致 26002 错误的问题。

v5.3.3

发布日期:2022/06/02

问题修复:

  1. 修复可能会丢失会话类型为 ConversationType.RTC_ROOM 的直发消息的问题。
  2. 修复获取会话列表为空时,返回报错的问题。
  3. 修复升级 5.0 后会话未读数无法清除的问题。

优化:

  1. 优化撤回消息计数。

v5.3.2

发布日期:2022/05/20

优化:

  1. 优化聊天室获取消息及扩展属性信息机制。

v5.3.1

发布日期:2022/05/19

问题修复:

  1. 优化重连逻辑,修复网络异常时可能无法重连的问题
  2. 修复 comet 连接时拉取消息报错的问题
  3. 修复 App Key 未开启超级群服务时,SDK 断网重连后会异常拉取超级群消息的问题

其他:

  1. 优化连接逻辑

v5.3.0

发布日期:2022/04/29

问题修复:

  1. 修复收到广播消息后,断开连接再重复连接,会再次收到广播消息的问题
  2. 修复在 IE 11 浏览器中调用 disconnect 方法报错的问题

其他:

  1. 发送撤回消息的消息体中可携带 extra 字段

RongIMLib 版本

4.6.3

发布日期:2022/04/15

问题修复:

  1. 修复极少数情况下会丢失会话类型为 ConversationType.RTC_ROOM 的消息的问题
  2. 修复 https 协议时无法上报日志的问题

4.6.2

发布日期:2022/04/07

问题修复:

  1. 修复接受广播消息可能重复的问题。
  2. 修复获取会话列表为空时,返回报错的问题。

4.6.1

发布日期:2022/03/17

问题修复:

  1. 修复在小程序中重连失败时无法继续重连的问题

4.6.0

发布日期:2022/02/17

问题修复:

  1. 修复在单聊中发送 @ 消息时,接收方收到该消息时可能会报错的问题
  2. 修复环境中 console 无法使用时导致 SDK 无法使用的问题

4.5.4

发布日期:2021/12/28

问题修复:

  1. 修复会话列表中 latestMessage 为 null 时(一般在会话中最新消息在 Web 客户端本地被删除时出现)报错的问题
  2. 修复支付宝小程序中请求导航返回值解析报错的问题

功能优化:

  1. 本端主动清理未读数时不再通知会话变更

新增功能:

  1. 新增清除全部未读数接口

4.5.3

发布日期:2021/12/09

问题修复:

  1. 修复断线重连时可能收消息延迟的问题
  2. 修复连接之前多个 ping 等待造成连接延迟的问题
  3. 修复切换用户后,后登录用户使用前一用户的内存数据拉取消息的问题
  4. 修复消息体内 user.portraitUri 字段多端不一致问题,推荐使用 portrait 字段

4.5.2

发布日期:2021/11/25

功能优化:

  1. 连接时优先使用缓存导航。

4.5.1

发布日期:2021/11/04

新增功能:

  1. 撤回消息时,会触发会话列表变更事件,开发者可在收到事件通知后刷新 UI。

问题修复:

  1. 修复在极少数情况下,断线重连后可能无法拉取离线消息的问题。

4.5.0

发布日期:2021/10/22

新增功能:

  1. 新增发送敏感词时通知功能
  2. 新增批量设置和删除聊天室属性能力
  3. 新增用户未加入聊天室时,支持获取聊天室属性信息
  4. 新增用户加入、退出聊天室通知能力,需要客户开通后支持,可提交工单申请开通
  5. 新增聊天室销毁通知能力
  6. 新增会话标签功能

问题修复:

  1. 修复加入聊天室错误时没有状态码的问题

4.4.10

发布日期:2021/10/14

问题修复:

  1. 修复多端同步状态消息时可能报错的问题

4.4.9

发布日期:2021/09/24

功能优化:

  1. 优化消息拉取功能

4.4.8

发布日期:2021/09/10

问题修复:

  1. 修复推送可能丢失 pushData 字段的问题

功能优化:

  1. 解除端上不允许发系统消息的限制

新增功能:

  1. 增加 Conversation.getInfo 接口

4.4.7

发布日期:2021/08/26

问题修复:

  1. 修复收到非 UpStreamMessage 的消息信令时可能报错的问题

  2. 修复在服务端发送消息时,本人可能会收到重复消息的问题

功能优化:

  1. 优化连接时返回具体错误码

  2. 增加在小程序环境请求导航

4.4.6

发布日期:2021/08/13

问题修复:

  1. 修复撤回消息时多端同步到的会话信息可能错误的问题

  2. 修复收到直发消息时清理未读数可能不能清空的问题

4.4.5

发布日期:2021/07/30

问题修复:

  1. 修复获取未读总数时未过滤免打扰会话的问题

  2. 修复单聊会话中对方可能收到 RC:SRSMsg 类型消息的问题

  3. 修复频繁删除KV时切换聊天室可能会导致不再通知KV变化的问题

新增功能:

  1. 增加离线消息拉取完成通知

4.4.4

发布日期:2021/07/15

问题修复:

  1. 修复一些情况下可能报 IDBKeyRange 错误问题

功能优化:

  1. 优化重连逻辑

4.4.3

发布日期:2021/07/02

问题修复:

  1. 修复在小程序中发送消息可能报错问题

4.4.2

发布日期:2021/07/01

问题修复:

  1. 修复日志报错问题

  2. 修复发送消息后刷新页面重新连接,可能会重复收到本端发送消息的问题

  3. 修复聊天室拉取消息时可能拉取到加入前消息的问题

  4. 修复 comet 连接重连后不发 pullMsg 问题

  5. 调用 disconnect 时清除重连定时器

4.4.1

发布日期:2021/06/11

功能优化:

  1. 优化 navi 存储策略

问题修复:

  1. 修复可能会发送多个 ping 的问题

4.4.0

发布日期:2021/06/03

新增功能:

  1. 增加 typing 消息, 新增 typing 状态通知

  2. 推送扩展新增字段

功能优化:

  1. 适配头条和百度小程序

  2. 小程序支持 comet 连接

  3. 发送消息失败时返回消息内容

  4. 重定向失败时继续重连

  5. 优化日志输出

问题修复:

  1. 修复监听连接状态改变为 success 时调用接口报 30001 的问题

其他

  1. npm 包不再支持 IE,如需支持请用 CDN 包

4.3.6

发布日期:2021/05/27

问题修复:

  1. 修复重新连接后未拉取离线消息问题

4.3.5

发布日期:2021/05/20

功能优化:

  1. 心跳间隔和超时改为15s

  2. 自定义 Navi 地址过滤 ’/’

  3. 禁止插件重复初始化

4.3.4

发布日期:2021/05/07

问题修复:

  1. 修复连接失败时不能再次调用连接的问题
  2. 修复在 uni-app 中,在 Android 和 iOS 平台编译不过的问题
  3. 修复在微信小程序中,在使用 2.16.0 及以下版本的基础调试库时报错的问题

4.3.3

发布日期:2021/04/29

问题修复:

  1. 增加内置消息类型 'RC:GIFMsg'

  2. 修复小程序无法使用 comet 连接问题

  3. 修复小程序获取导航为 null 问题

4.3.2

发布日期:2021/04/23

问题修复:

  1. 修复通知拉取消息时消息状态错误问题

  2. 修复消息的 isStatusMessage 参数判断错误问题

  3. 修复断开网络30s内重连成功时,ping 会产生多个 timer 的问题

  4. 修复多端或换端登录情况下,拉取离线补偿过程中发送消息可能导致拉取时间戳错误,导致丢失部分发件箱消息

  5. 修复发送普通群组消息后,会把会话@信息清空的问题,增加清空未读数时清空@信息

4.3.1

发布日期:2021/04/15

问题修复:

修复连接 ping 逻辑错误导致 ping 超时也不会主动中断连接

功能优化

更新日志输出格式

4.3.0

发布日期:2021/04/12

新增功能:

  1. 针对移动端支持了发送单条消息配置推送内容功能
  2. 优化了对服务器侧主动断开连接后的重连处理逻辑
  3. 支持新版本 Electron 桌面端解决方案 - @rongcloud/electron-solution

4.2.6

发布日期:2021/03/17

问题修复:

  1. 对 TypeScript 开发者增加 IAReceivedConversation 接口定义暴露

4.2.5

发布日期:2021/03/08

问题修复:

  1. 修复了加入房间时不获取历史消息,断线重连后出现聊天室消息断档问题

  2. 优化了获取单一 Conversation 会话实例时频繁拉取会话列表问题

  3. 修复了构建脚本错误导致 IMLib 文件重复打包 engine 依赖造成代码冗余问题

  4. 修复了获取历史消息时,若 timestamp 为 0、count 为 1 时无法获取数据问题

  5. 补全了 TS 开发者依赖的接口及类定义声明

4.2.4

发布日期:2021/02/24

问题修复:

  1. 修复了聊天室拉取消息重复问题

4.2.3

发布日期:2021/02/07

问题修复:

  1. 修复了聊天室拉取消息偶现的重复消息问题

  2. 修复了接收状态消息时更新了本地收件箱时间,导致拉取消息时可能存在消息丢失的问题

4.2.2

发布日期:2021/01/28

问题修复:

  1. 修复了多端情况下一端在聊天室中,另一端未加入聊天室获取聊天室消息出错的问题。

4.2.1

发布日期:2021/01/25

问题修复:

  1. 修复了 SDK 中部分 BUG。

4.2.0

发布日期:2021/01/20

问题修复:

  1. 修复了聊天室属性监听无法触发问题

  2. 修复了退出聊天室异常问题

  3. 修复了接收消息体里静默消息字段展示错误问题

功能优化

  1. 浏览器最低兼容到 IE 9

  2. 优化了导航连接逻辑

4.1.1

发布日期:2020/12/29

问题修复:

  1. 修复了群已读消息状态多端同步时,其他群成员也会收到状态同步的问题。

4.1.0

发布日期:2020/12/11

新增功能:

  1. 进一步优化了上传文件服务,当发送富媒体消息时如图片、文件、小视频等,上传文件失败情况下会自动切换到备份服务器进行存储,用户无感知。

问题修复:

  1. 修复发送的状态消息被存储、计数问题

4.0.1

发布日期:2020/11/27

问题修复:

  1. 修复了 SDK 链接导航时内部上报版本号错误的问题

  2. 补齐了小视频内置消息类型

4.0.0

发布日期:2020/11/20

新增功能:

  1. 新增了会话草稿功能

  2. 增加了对 TypeScript 的类型支持,提供 .d.ts 声明文件

功能优化:

  1. 支持了 NPM 模块集成,NPM 仓库包名为 @rongcloud/imlib-v4

  2. 提升了 SDK 代码健壮性、稳定性

  3. 提升了连接速度及连接成功率,减少不必要的网络嗅探

  4. 提升了 SDK 性能,减少不必要的异步任务

3.0.7.4 Dev

发布日期:2020/12/07

问题修复:

  1. 修复了加入多个聊天室后,无法退出的问题

3.0.7.3 Dev

发布日期:2020/12/07

问题修复:

  1. 增加了 25102 错误码提示,表示单群聊消息云存储服务未开通,无法获取服务端会话列表

3.0.7.2 Dev

发布日期:2020/11/24

问题修复:

  1. 修复支付宝小程序 localStorage 取值错误问题

3.0.7.1 Dev

发布日期:2020/10/14

新增功能:

  1. 支持了分页获取会话列表功能

3.0.7 Dev

发布日期:2020/09/18

新增功能:

  1. 针对单条消息增加了消息扩展属性设置功能,消息发送前需要设置为可扩展后,才能对该条消息进行扩展信息添加。查看文档

  2. 长轮询方式支持了会话置顶、免打扰设置功能

  3. 聊天室模块添加 reall 撤回消息方法。查看文档

问题修复:

  1. 更新了会话列表 mentionedInfo 字段存储信息,存储会话中最新 @当前用户的用户 ID

  2. 修复了长轮询方式重复连接的问题

  3. 合并转发模板 修复 Web 无展示嵌套合并转发消息问题

3.0.6 Dev

发布日期:2020/08/19

新增功能:

  1. 连接成功后,接收消息中添加该消息其他端是否已经接收过的标识字段 receivedStatus

  2. 增加了聊天室 KV 属性变化监听能力,聊天室中属性每次变化时都会同步监听状态

问题修复:

  1. 修复了 uni-app 在微信小程序下环境判断错误的问题

  2. 修复了 SDK 对部分 Emoji 特殊字符解析不正确的问题

  3. 修复了多端情况下被踢后未断开 WebSocket 连接,再次连接后重复收消息问题

  4. 修复了获取到的会话列表的会话结构中 hasMetioned 未生效的问题

功能优化:

  1. 增加了 Navi 导航请求超时时间 10 秒

  2. 增加了 CMP 超时时间 10 秒

3.0.5 Dev

发布日期:2020/07/21

新增功能:

  1. 增加了新的加入聊天室接口,如聊天室不存在则加入不成功

  2. 增加了静默消息功能,发送单条消息时支持设置该条消息没有通知

  3. 完成了对 uni-app 框架的适配,可通过 uni-app 框架实现多平台研发

问题修复:

  1. 修复了多端同步的单群聊状态消息,SDK 未向用户抛出的问题

  2. 修复了读取某会话消息时,再次接收这个会话新消息,查看此会话未读数时错误的问题

  3. SDK 状态监听器抛出时序问题处理,防止 SDK 内部逻辑未处理完成,抛出连接成功后用户调用任意接口报错

功能优化:

  1. 优化了 SDK 断网重连后,自动重新加入聊天室的逻辑

3.0.4 Dev

发布日期:2020/06/19

新增功能:

  1. 增加了会话免打扰及会话置顶多端状态同步功能

  2. 增加了获取指定会话未读数方法 getUnreadCount

功能优化:

  1. 优化了上传文件服务,当发送富媒体消息时如图片、文件、小视频等,上传文件失败情况下会自动切换到备份服务器进行存储,用户无感知。

  2. 自动重连逻辑优化,防止 im.watch 重复监听 conversation、message、status 事件

3.0.3 Dev

发布日期:2020/06/02

功能优化:

  1. 优化了 SDK 在 FILE 协议下的连接

3.0.2 Dev

发布日期:2020/05/22

新增功能:

  1. IMLib SDK 增加了聊天室属性自定义存储功能,查看功能文档

3.0.1 Dev

发布日期:2020/05/07

新增功能:

  1. 实现了对音视频 SDK 3.2.2 及以上版本的兼容

  2. 增加了获取上传文件 Token 接口 getFileToken 及获取上传文件地址 Url 接口 getFileUrl

  3. 增加了获取用户 ID 接口 getConnectionUserId

  4. 增加了获取连接状态接口 getConnectionStatus

  5. 适配了微信小程序环境

问题修复:

  1. 修复了聊天室中消息方向显示不正确的问题

  2. 修复了收到撤回消息时,会话列表变化监听未执行的问题

  3. 开发者代码报错影响 SDK 消息抛出

3.0.0 Dev

发布日期:2020/03/31

新版本发布:

  1. 体积相比 SDK 2.0 减少 50%

  2. 兼容性健壮,兼容 Chrome、Firefox、Safari、IE5-11、Edge、微信浏览器、Android 2.3.6+ 等浏览器

  3. 以会话为模型的全新 API 设计,集成更便捷

  4. 内部代码高内聚低耦合,模块依赖清晰

文档反馈
意见反馈

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈