发版说明

  • HarmonyOS

更新时间

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

该版本于 2026 年 9 月 20 日发布。

升级必看

该版本对部分功能的实现方式进行了优化,包括 SDK 的行为变更、API 的改名或删除,为确保项目的正常运行,你需要在升级到该版本后更新 App 中的代码。

playEffect 和 preloadEffect 改为异步方法

为避免连续播放网络音效时阻塞主线程,该版本将 playEffect 和 preloadEffect 改为异步方法,返回 Promise<number>。如果你的 App 中调用了这两个方法,请按异步方式处理返回值。

VideoFrame 变更

  • yStride 更名为 stride,含义不变,仍表示视频帧的行跨度。
  • buffer 的类型由 ArrayBuffer | null 变更为 ArrayBuffer | undefined。

如果你的 App 中使用了上述成员变量,请相应更新代码。

冗余接口和参数删除

该版本删除了下列参数:

新增特性

语聊房和合唱音频场景

该版本在 setAudioScenario 方法的音频场景中新增 CHATROOM 和 CHORUS。其中,CHORUS 场景支持低延迟采集模式。

人声音效

该版本新增人声音效能力,你可以根据需求调用以下方法:

版权音乐

该版本新增版权音乐支持。你可以通过 IAgoraMusicContentCenter 管理音乐资源,并通过 IAgoraMusicPlayer 播放音乐。相关接口详见版权音乐 API。

观众本地预览截图

该版本支持观众角色在加入频道后开启本地预览,并调用 takeSnapShotEx 进行本地视频截图。

播放系统文件选择器中的媒体文件

该版本支持通过 IMediaPlayer 播放系统文件选择器获取的媒体文件。你可以将文件选择器返回的 URI 传入播放器打开并播放,不再局限于应用沙箱内的文件路径。

基础美颜

该版本新增 setBeautyEffectOptions,用于开启或关闭美颜效果并配置美颜参数。

垫片推流

该版本新增 enableVideoImageSource,用于开启或关闭图片源推流,并新增 ImageTrackOptions 配置类型。

音效文件播放

在此前已支持的 playEffect、stopEffect 等音效文件播放能力基础上,该版本新增音效预加载、音量管理、多音效控制、暂停/恢复和批量卸载能力,包括 getEffectsVolume、setEffectsVolume、setVolumeOfEffect、playAllEffects、pauseEffect、pauseAllEffects、resumeEffect、resumeAllEffects、stopAllEffects、unloadEffect、unloadAllEffects 和 getVolumeOfEffect。preloadEffect 的异步调用方式详见“升级必看”。

本地音频设备测试

该版本新增 startRecordingDeviceTest 和 stopRecordingDeviceTest 方法,用于启动或停止本地录音设备测试。

其他

改进

该版本包含以下改进:

  • 提升在手机前后置摄像头、PC 和平板设备上开启 enableFaceDetection 时的人脸检测准确性。
  • 优化重力传感器监听,提升手机旋转时应用界面与摄像头画面同步旋转的效率。
  • 优化平板设备的本地摄像头画面渲染方向。
  • 新增鸿蒙电视设备适配。
  • 新增鸿蒙设备低延迟耳返支持。

问题修复

该版本修复了以下问题:

  • 修复通过 startScreenCapture 进行屏幕共享时旋转手机导致远端共享画面缩小的问题。
  • 修复音频路由切换不正确的问题。
  • 修复私有化场景下 setLocalAccessPoint 无法正常使用的问题。
  • 修复调用 setupLocalVideo 切换本地渲染大小窗时有概率导致崩溃的问题。
  • 修复屏幕共享过程中应用切换到后台时有概率发生崩溃的问题。
  • 修复 C++ 层调用 pushExternalVideoFrame 推送纹理格式视频帧不能正常工作的问题。
  • 修复通话被来电打断后音频路由未能正确恢复的问题。
  • 修复获取本地 IP 地址时偶现崩溃的问题。
  • 修复折叠屏设备反复折叠后有概率导致摄像头无法正常打开的问题。
  • 修复 PC 通话过程中摄像头被系统占用结束后,SDK 无法恢复摄像头采集的问题。
  • 修复第三方应用播放声音时,远端声音音量过小的问题。
  • 修复应用退到后台后被第三方应用抢占音频播放设备,回到前台后播放无声的问题。
  • 修复使用蓝牙耳机时声音偶现断断续续的问题。
  • 修复 2K 高分辨率视频硬解码时有概率卡死的问题。
  • 修复应用切后台时切换到蓝牙设备,回到前台后蓝牙耳机无法正常采集的问题。
  • 修复纹理自采集场景下通话画面偶现闪屏的问题。

API 变更

新增

修改

删除