发版说明

  • C++

更新时间

查看实时消息 RTM 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

本文提供 RTM v2 SDK 的发版说明。

已知问题和局限性

自 2.2.0 起,RTM SDK 和 RTC SDK(4.3.0 及以上版本)都包含动态库文件。如果你同时使用了 RTM 和 RTC SDK,为避免冲突,请手动删除更低版本的动态库文件。

  • 2.3.0 RTM SDK 动态库版本为 1.3.5。
  • 2.2.8 RTM SDK 动态库版本为 1.3.0。
  • 2.2.7 RTM SDK 动态库版本为 1.3.0。
  • 2.2.3、2.2.4、2.2.5、2.2.6 RTM SDK 动态库版本为 1.2.13。
  • 2.2.2 RTM SDK 动态库版本为 1.0.11。
  • 2.2.1 RTM SDK 动态库版本为 1.0.11。
  • 2.2.0 RTM SDK 动态库版本为 1.0.0.17。

发布日期:2026 年 11 月 17 日。

升级必看

升级时成套更新并重新编译

IRtmPresence 新增纯虚方法;IRtmEventHandler 新增带默认空实现的回调,虚表布局发生变化。请成套升级 SDK 头文件、Native 库及使用的 JNI/NAPI/Objective-C 包装层,并重新编译应用,不应混用不同版本的头文件或二进制。

正常继承 IRtmEventHandler 的应用无需强制实现新回调,使用该查询结果时再覆盖此回调;自定义 IRtmPresence 实现需要补齐新增纯虚方法。

新特性

查询用户在线状态

新增 getUserOnlineStatus,用于按单个精确 User ID 查询当前 App ID 下的用户是否存在有效的 RTM 登录连接。查询方和目标用户都无需加入或订阅频道。调用方须具有可用的 MESSAGE service 且 MESSAGE session 已连接;该查询不依赖 Presence 服务开关或 Sync Database 就绪。

成功结果包含 userId 和 online。目标离线或不存在时返回成功结果 online=false;调用失败通过对应平台的错误处理机制返回。结果是服务端响应时刻的状态快照,不提供在线状态变更订阅。具体流程见查询用户在线状态。

接口变更

问题修复

  • 修复多链路交错断连,可能无法完全恢复服务的问题。
  • 修复断网恢复后,对已有频道执行重订阅可能引发崩溃的问题。