发版说明

  • Unreal C++

更新时间

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

已知问题和局限性

音频模块不兼容 (iOS)

声网 Unreal SDK 的音频模块与 Unreal Engine 5.3、5.4 的 AudioMixer 模块不兼容。如果你使用 Unreal Engine 5.3 或 5.4,需要在项目的 /Config/IOS/IOSEngine.ini 文件中添加以下代码,关闭 Unreal Engine 的 AudioMixer 模块,以避免冲突。

ini
[Audio]
AudioMixerModuleName=

该版本于 2025 年 3 月 13 日发布。

新增特性

AI 对话场景

该版本新增了专为与声网对话式 AI 引擎创建的智能体互动设计的 AUDIO_SCENARIO_AI_CLIENT 音频场景。该场景根据 AI 智能体生成语音的特点,针对优化了音频传输算法,能够在弱网环境下(例如 80% 丢包率)稳定传输语音数据,确保对话的连续性和可靠性,适应多样化的复杂网络条件。

改进

优化了特定机型上 SDK 初始化的耗时。(iOS)

问题修复

该版本修复了以下问题:

  • 集成 SDK 的 App 设置 targetSdkVersion 为 34,在 Android 14 系统上首次开启屏幕共享进行授权时出现崩溃。(Android)
  • 同时加入两个及以上的频道,连续调用 takeSnapshotEx 分别对频道中的本地视频流进行截图,在先调用的频道截图会失败。
  • 使用媒体播放器时,调用 pause 暂停播放后,调用 seek 定位到指定播放位置、然后调用 play 继续播放,播放时会先从暂停播放的位置播放,然后再从新的位置播放。
  • 使用媒体播放器时,调用 switchSrc 切换媒体资源后,调用 getPlaySrc 获取当前正在播放的媒体资源的路径没有变化。
  • 用户在特定机型上进行音视频互动并使用蓝牙耳机,偶现调整手机音量后改变的是媒体音量而非蓝牙音量。(Android)
  • 音视频互动时,偶现接收端观看发送端画面出现黑屏。(Android)
  • 在特定机型上,调用 setCameraExposureFactor 在设备的某个特定角度设置当前摄像头的曝光系数后,当设备移动到另一个角度时,偶现视频画面变暗。(Android)
  • 播放 CDN 直播流时,直播流短暂中断后恢复,偶现播放画面长时间卡住。(Android)
  • 在推送 i420 格式的视频帧到频道内时,使用 CVPixelBuffer 会导致崩溃。(iOS)
  • 调用 setupLocalVideo 设置两个视图(view),然后调用 enableFaceDetection 开启人脸检测,后传入的视图中无法检测到人脸信息。(iOS)
  • 屏幕共享场景下,接收端用户看到的共享图像出现绿线。(iOS)
  • 在极速直播场景下,观众通过 string 型的用户 ID 加入频道观看直播,偶现音频和画面不同步。
  • 在同时使用 AI 降噪、AI 回声消除插件时,偶现插件不生效。