发版说明

  • Swift

更新时间

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

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

已知问题和局限性

自 2.2.0 起,RTM SDK 和 RTC SDK(4.3.0 及以上版本)都包含 aosl.xframework 库。如果你同时使用了 RTM 和 RTC SDK,为避免冲突,需进行如下操作:

  • 如果你通过 CDN 手动集成 SDK,请手动删除更低版本的 aosl.xframework 库;
  • 如果你使用依赖管理工具(如 Maven 或 CocoaPods) 集成 SDK,请确保在项目中引入更高版本的 aosl.xframework 库。

具体的集成指南可以参考如何处理同时集成 RTM SDK 和 RTC SDK 遇到的问题?

  • 2.3.0 RTM SDK aosl.xframework 库版本为 1.3.5。
  • 2.2.8 RTM SDK aosl.xframework 库版本为 1.3.0。
  • 2.2.7 RTM SDK aosl.xframework 库版本为 1.3.0。
  • 2.2.3、2.2.4、2.2.5、2.2.6 RTM SDK aosl.xframework 库版本为 1.2.13。
  • 2.2.2 RTM SDK aosl.xframework 库版本为 1.0.11。

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

升级必看

SDK 引用方式变更

自 v2.3.1 起,通过 CocoaPods 集成 RTM SDK 时,需要在 Podfile 中添加 source 'https://download.shengwang.cn/cocoapods/',并保留项目已有的源。SDK 依赖包名仍为 ShengWang-Rtm,版本更新为 2.3.1。分别通过 RtmKit 和 RtmBasic 引入 RTM 主库和 aosl 基础库:

Ruby
pod 'ShengWang-Rtm', '2.3.1', :subspecs => ['RtmKit']
pod 'ShengWang-Rtm', '2.3.1', :subspecs => ['RtmBasic']

具体配置见实现收发消息。

新特性

查询用户在线状态

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

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

接口变更

问题修复

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