发版说明

  • Java

更新时间

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

该版本于 2025 年 5 月 28 日发布。

新增特性

音频 Metadata 数据

该版本新增发送和接收音频 Metadata 数据功能。在需要发送音频附属信息,如播放进度等的场景下,你可以调用 sendAudioMetadata 方法进行发送,远端用户会在 onAudioMetadataReceived 回调中接收到发送的信息。

原始音频数据支持 VAD

为支持获取原始音频数据中的 VAD 信息,该版本新增重载的 registerAudioFrameObserver 方法,支持通过 enableVad 参数开启 VAD 监测功能。

开启后,你可以通过 onPlaybackAudioFrameBeforeMixing 回调中的 vadResult 参数获取 VAD 状态信息。

接收编码后的音频数据

该版本新增支持接收编码后的音频数据。相关接口如下:

外部视频源支持自定义颜色空间

该版本在 ExternalVideoFrame 中增加 colorSpace 属性,支持对外部采集到的视频数据自定义颜色空间。

支持域名管理

该版本在 AgoraServiceConfig 中增加 domainLimit 参数,支持对连接的域名进行设置和管理。

改进

音视频数据发送模块接口易用性改进

为提升音视频数据发送模块的易用性,该版本对如下接口和方法进行了优化:

  • AgoraAudioPcmDataSender 中,废弃了原来的 send 方法,新增 sendAudioPcmData 进行取代。
  • AgoraAudioEncodedFrameSender 中,删除了原来的 send 方法,新增 sendEncodedAudioFrame 进行取代。
  • AgoraVideoEncodedImageSender 中,删除了原来的 send 方法,新增 sendEncodedVideoImage 进行取代。
  • AgoraVideoFrameSender 中,移除 send 方法,新增 sendVideoFrame 进行取代。

新增 sendStreamMessage 重载

该版本新增了 sendStreamMessage 的重载方法。和已有的 sendStreamMessage 相比,该方法删除了 length 参数,并将 message 的数据类型由 String 改为 byte[]。

问题修复

  • 修复了 VideoFrame 中 alphaBuffer 和 metadataBuffer 的处理问题
  • 修复了 destroy 方法可能导致的崩溃问题
  • 修复了多处内存泄露和多线程问题,提高了系统稳定性