发版说明

  • C++

更新时间

查看 RTC 服务端 SDK 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

该版本于 2026 年 11 月 03 日发布。

新增特性

视频 Metadata

该版本支持随视频发送和接收 Metadata。你可以通过 ILocalVideoTrack::registerVideoMetadataObserver 注册 IMetadataObserver,并通过以下回调设置和接收视频附属信息:

不再需要监听时,调用 unregisterVideoMetadataObserver 注销观测器。详见发送和接收视频 Metadata。

新增的注册和注销接口均提供默认实现,默认返回 0。

服务配置路径和参数入口

AgoraServiceConfiguration 提供以下配置字段,默认值均为 NULL:

  • configDir:配置文件目录。为 NULL 时,使用 SDK 默认配置目录。
  • dataDir:数据文件目录。为 NULL 时,使用 SDK 默认数据目录。
  • parameters:本版本新增,支持在初始化时通过 JSON 字符串配置 SDK,用于技术预览功能或特殊定制。请在技术支持指导下配置。

获取 NTP 时间

该版本新增 IAgoraService::getNtpWallTimeInMs,用于获取以毫秒为单位的 Unix 时间戳。NTP 服务不可用时,该方法返回 0。

问题修复

  • 修复了 Token 中包含未知 service type 时,有概率导致 SDK 崩溃的问题。
  • 修复了创建连接后立即销毁时,服务端有概率无法及时感知用户退出的问题。
  • 修复了开启内容加密后,无法使用 String 型用户 ID 的问题。
  • 修复了音频 IO 线程和播放线程并发访问有概率导致 SDK 崩溃的问题。
  • 修复了使用 String 型用户 ID 时的音画不同步问题。
  • 修复了音频立体声场景下,弱网环境中有概率出现杂音的问题。