发版说明

v4.6.3

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

升级必看

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

playEffect 和 preloadEffect 改为异步方法

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

VideoFrame 变更

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

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

冗余接口和参数删除

该版本删除了下列参数：

• LiveTranscoding.metadata（该属性已废弃）

新增特性

语聊房和合唱音频场景

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

人声音效

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

• setLocalVoicePitch：调节本地人声的音调。
• setLocalVoiceEqualization：调节本地人声的均衡器。
• setLocalVoiceReverb：调节本地人声的混响。
• setAudioEffectPreset：使用预设音效，支持浴室、楼梯间和自然环境等场景的混响效果。
• setVoiceBeautifierPreset：使用人声美化预设。

版权音乐

该版本新增版权音乐支持。你可以通过 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 方法，用于启动或停止本地录音设备测试。

其他

• 新增 enableEncryptionEx 方法，用于多频道场景下开启或关闭媒体流加密。
• 新增 setAudioMixingPlaybackSpeed 方法，用于设置音乐文件的播放速度。
• 新增 getCallIdEx 方法，用于多频道场景下获取通话 ID。
• 新增 muteRecordingSignal 方法，用于设置是否将录音信号静音。
• 新增 onAudioRouteChanged 回调，用于监听音频路由的变化。
• 新增 getNtpWallTimeInMs 方法，用于获取当前 NTP 时间。
• 新增 setRemoteSubscribeFallbackOption 方法，用于设置弱网环境下订阅的音视频流回退选项。

改进

该版本包含以下改进：

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

问题修复

该版本修复了以下问题：

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

API 变更

新增

• setBeautyEffectOptions
• enableVideoImageSource
• ImageTrackOptions
• preloadEffect
• playAllEffects
• pauseEffect
• pauseAllEffects
• resumeEffect
• resumeAllEffects
• stopAllEffects
• unloadEffect
• unloadAllEffects
• getEffectsVolume
• setEffectsVolume
• getVolumeOfEffect
• setVolumeOfEffect
• setLocalVoicePitch
• setLocalVoiceEqualization
• setLocalVoiceReverb
• setAudioEffectPreset
• setVoiceBeautifierPreset
• AudioEffectPreset
• VoiceBeautifierPreset
• onAudioRouteChanged
• startRecordingDeviceTest
• stopRecordingDeviceTest
• muteRecordingSignal
• enableEncryptionEx
• getNtpWallTimeInMs
• setRemoteSubscribeFallbackOption
• setAudioScenario 新增 CHATROOM 和 CHORUS

修改

• playEffect 和 preloadEffect 改为异步方法，返回 Promise<number>
• VideoFrame.yStride 更名为 stride
• VideoFrame.buffer 类型由 ArrayBuffer | null 变更为 ArrayBuffer | undefined
• MediaPlayer 支持打开 HarmonyOS 系统的 URL 和 URI

删除

• LiveTranscoding.metadata

v4.4.2

该版本于 2024 年 11 月 29 日发布。

升级必看

• 该版本将访问区域（areaCode）的默认值从 GLOB 变更为 CN。

新增特性

• 该版本新增 setEnableSpeakerphone 方法，支持设置是否使用扬声器播放。

问题修复

该版本修复了以下问题：

• isSpeakerphoneEnabled 回调返回结果不准确。
• 在鸿蒙 NEXT 0.0.107 系统的设备上，调用 leaveChannel 后偶现崩溃。

v4.4.1

该版本于 2024 年 10 月 24 日发布，适配 HarmonyOS NEXT Release 版本，确保其在最新操作系统上的兼容性和性能表现。

升级必看

该版本对 SDK 进行了以下优化和变更，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。

• 包名变更为 @shengwang/rtc-full（视频 SDK）或 @shengwang/rtc-voice（音频 SDK），请在添加依赖项和导入 SDK 组件的代码处修改包名，详见实现音视频互动或实现纯语音互动。

• HAR 包变更为字节码格式，你需要在 build-profile.json5 项目文件中增加以下编译选项：

  JSON

  "products": [
    {
      "name": "default",
      "signingConfig": "default",
      "compatibleSdkVersion": "5.0.0(12)",
      "runtimeOS": "HarmonyOS",
      "buildOption": {
        "strictMode": {
          "useNormalizedOHMUrl": true
        }
      }
    }
  ],

新增特性

该版本包含以下新增特性：

• SDK 中包含 C/C++ 头文件，你可以在项目中直接使用 C/C++ 语言开发，无需另外拷贝。
• 支持内置媒体播放器和播放版权音乐功能。

改进

该版本包含以下改进：

• 提升了视频解码的流畅度。
• 优化了音频路由切换的体验。
• 提升了视频解码器的稳定性。

问题修复

该版本修复了以下问题：

• 音视频录制偶现崩溃。
• 偶现 onVideSizeChanged 回调无法正常上报。

v4.4.0

该版本于 2024 年 10 月 8 日发布。

功能简介

该 SDK 由声网为开发者设计，旨在为鸿蒙系统的开发者提供简单且用户友好的实时互动解决方案。

SDK 提供了一套强大的 API，使开发者可以轻松构建具备实时音视频互动功能的应用程序，并可以利用鸿蒙系统的独特优势，增强应用的性能和用户体验。通过集成该 SDK，开发者可以快速实现高质量的音视频通话和互动直播等功能，提升应用的互动性和用户粘性。

参考文档

你可以参考以下文档集成 SDK，实现相应的实时音视频功能：

• 跑通 API 示例项目
• 实现音视频互动
• 实现极速直播
• 实现纯语音互动
• API 参考

声网提供了开源的示例项目，你可以前往下载并体验。