# 发版说明 (/zh-CN/realtime-media/rtc/reference/release-notes/harmonyos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## v4.6.3 [#v463-harmonyos] 该版本于 2026 年 9 月 20 日发布。 ### 升级必看 [#升级必看-59] 该版本对部分功能的实现方式进行了优化,包括 SDK 的行为变更、API 的改名或删除,为确保项目的正常运行,你需要在升级到该版本后更新 App 中的代码。 #### playEffect 和 preloadEffect 改为异步方法 [#playeffect-和-preloadeffect-改为异步方法] 为避免连续播放网络音效时阻塞主线程,该版本将 [`playEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_playeffect3) 和 [`preloadEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_preloadeffect) 改为异步方法,返回 `Promise`。如果你的 App 中调用了这两个方法,请按异步方式处理返回值。 #### VideoFrame 变更 [#videoframe-变更] - `yStride` 更名为 `stride`,含义不变,仍表示视频帧的行跨度。 - `buffer` 的类型由 `ArrayBuffer | null` 变更为 `ArrayBuffer | undefined`。 如果你的 App 中使用了上述成员变量,请相应更新代码。 #### 冗余接口和参数删除 [#冗余接口和参数删除] 该版本删除了下列参数: - [`LiveTranscoding`](/zh-CN/api-reference/rtc/harmonyos/class-livetranscoding#class_livetranscoding).`metadata`(该属性已废弃) ### 新增特性 [#新增特性-85] #### 语聊房和合唱音频场景 [#语聊房和合唱音频场景] 该版本在 [`setAudioScenario`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-basic#api_irtcengine_setaudioscenario) 方法的音频场景中新增 `CHATROOM` 和 `CHORUS`。其中,`CHORUS` 场景支持低延迟采集模式。 #### 人声音效 [#人声音效] 该版本新增人声音效能力,你可以根据需求调用以下方法: - [`setLocalVoicePitch`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch):调节本地人声的音调。 - [`setLocalVoiceEqualization`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization):调节本地人声的均衡器。 - [`setLocalVoiceReverb`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb):调节本地人声的混响。 - [`setAudioEffectPreset`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset):使用预设音效,支持浴室、楼梯间和自然环境等场景的混响效果。 - [`setVoiceBeautifierPreset`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset):使用人声美化预设。 #### 版权音乐 [#版权音乐-2] 该版本新增版权音乐支持。你可以通过 [`IAgoraMusicContentCenter`](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_imusiccontentcenter) 管理音乐资源,并通过 [`IAgoraMusicPlayer`](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_imusicplayer) 播放音乐。相关接口详见[版权音乐 API](/zh-CN/api-reference/rtc/harmonyos/play/drm)。 #### 观众本地预览截图 [#观众本地预览截图] 该版本支持观众角色在加入频道后开启本地预览,并调用 [`takeSnapShotEx`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/snapshot#api_irtcengineex_takesnapshotex) 进行本地视频截图。 #### 播放系统文件选择器中的媒体文件 [#播放系统文件选择器中的媒体文件] 该版本支持通过 [`IMediaPlayer`](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_imediaplayer) 播放系统文件选择器获取的媒体文件。你可以将文件选择器返回的 URI 传入播放器打开并播放,不再局限于应用沙箱内的文件路径。 #### 基础美颜 [#基础美颜] 该版本新增 [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions),用于开启或关闭美颜效果并配置美颜参数。 #### 垫片推流 [#垫片推流-4] 该版本新增 [`enableVideoImageSource`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/image-source#api_irtcengine_enablevideoimagesource),用于开启或关闭图片源推流,并新增 [`ImageTrackOptions`](/zh-CN/api-reference/rtc/harmonyos/class-imagetrackoptions#class_imagetrackoptions) 配置类型。 #### 音效文件播放 [#音效文件播放] 在此前已支持的 `playEffect`、`stopEffect` 等音效文件播放能力基础上,该版本新增音效预加载、音量管理、多音效控制、暂停/恢复和批量卸载能力,包括 [`getEffectsVolume`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_geteffectsvolume)、[`setEffectsVolume`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_seteffectsvolume)、[`setVolumeOfEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_setvolumeofeffect)、[`playAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_playalleffects)、[`pauseEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_pauseeffect)、[`pauseAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_pausealleffects)、[`resumeEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_resumeeffect)、[`resumeAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_resumealleffects)、[`stopAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_stopalleffects)、[`unloadEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_unloadeffect)、[`unloadAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_unloadalleffects) 和 [`getVolumeOfEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_getvolumeofeffect)。`preloadEffect` 的异步调用方式详见“升级必看”。 #### 本地音频设备测试 [#本地音频设备测试] 该版本新增 [`startRecordingDeviceTest`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-device#api_iaudiodevicemanager_startrecordingdevicetest) 和 [`stopRecordingDeviceTest`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-device#api_iaudiodevicemanager_stoprecordingdevicetest) 方法,用于启动或停止本地录音设备测试。 #### 其他 [#其他-20] - 新增 [`enableEncryptionEx`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengineex_enableencryptionex) 方法,用于多频道场景下开启或关闭媒体流加密。 - 新增 [`setAudioMixingPlaybackSpeed`](/zh-CN/api-reference/rtc/harmonyos/play/audio-mixing#api_irtcengine_setaudiomixingplaybackspeed) 方法,用于设置音乐文件的播放速度。 - 新增 [`getCallIdEx`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengineex_getcallidex) 方法,用于多频道场景下获取通话 ID。 - 新增 [`muteRecordingSignal`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-capture#api_irtcengine_muterecordingsignal) 方法,用于设置是否将录音信号静音。 - 新增 [`onAudioRouteChanged`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-route#callback_irtcengineeventhandler_onaudioroutechanged) 回调,用于监听音频路由的变化。 - 新增 [`getNtpWallTimeInMs`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengine_getntpwalltimeinms) 方法,用于获取当前 NTP 时间。 - 新增 [`setRemoteSubscribeFallbackOption`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengine_setremotesubscribefallbackoption) 方法,用于设置弱网环境下订阅的音视频流回退选项。 ### 改进 [#改进-101] 该版本包含以下改进: - 提升在手机前后置摄像头、PC 和平板设备上开启 [`enableFaceDetection`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/face-detection#api_irtcengine_enablefacedetection) 时的人脸检测准确性。 - 优化重力传感器监听,提升手机旋转时应用界面与摄像头画面同步旋转的效率。 - 优化平板设备的本地摄像头画面渲染方向。 - 新增鸿蒙电视设备适配。 - 新增鸿蒙设备低延迟耳返支持。 ### 问题修复 [#问题修复-103] 该版本修复了以下问题: - 修复通过 [`startScreenCapture`](/zh-CN/api-reference/rtc/harmonyos/video/screencapture#api_irtcengine_startscreencapture) 进行屏幕共享时旋转手机导致远端共享画面缩小的问题。 - 修复音频路由切换不正确的问题。 - 修复私有化场景下 `setLocalAccessPoint` 无法正常使用的问题。 - 修复调用 [`setupLocalVideo`](/zh-CN/api-reference/rtc/harmonyos/video/video-rendering#api_irtcengine_setuplocalvideo) 切换本地渲染大小窗时有概率导致崩溃的问题。 - 修复屏幕共享过程中应用切换到后台时有概率发生崩溃的问题。 - 修复 C++ 层调用 [`pushExternalVideoFrame`](/zh-CN/api-reference/rtc/harmonyos/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe4) 推送纹理格式视频帧不能正常工作的问题。 - 修复通话被来电打断后音频路由未能正确恢复的问题。 - 修复获取本地 IP 地址时偶现崩溃的问题。 - 修复折叠屏设备反复折叠后有概率导致摄像头无法正常打开的问题。 - 修复 PC 通话过程中摄像头被系统占用结束后,SDK 无法恢复摄像头采集的问题。 - 修复第三方应用播放声音时,远端声音音量过小的问题。 - 修复应用退到后台后被第三方应用抢占音频播放设备,回到前台后播放无声的问题。 - 修复使用蓝牙耳机时声音偶现断断续续的问题。 - 修复 2K 高分辨率视频硬解码时有概率卡死的问题。 - 修复应用切后台时切换到蓝牙设备,回到前台后蓝牙耳机无法正常采集的问题。 - 修复纹理自采集场景下通话画面偶现闪屏的问题。 ### API 变更 [#api-变更-57] #### 新增 [#新增-54] - [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions) - [`enableVideoImageSource`](/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/image-source#api_irtcengine_enablevideoimagesource) - [`ImageTrackOptions`](/zh-CN/api-reference/rtc/harmonyos/class-imagetrackoptions#class_imagetrackoptions) - [`preloadEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_preloadeffect) - [`playAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_playalleffects) - [`pauseEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_pauseeffect) - [`pauseAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_pausealleffects) - [`resumeEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_resumeeffect) - [`resumeAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_resumealleffects) - [`stopAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_stopalleffects) - [`unloadEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_unloadeffect) - [`unloadAllEffects`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_unloadalleffects) - [`getEffectsVolume`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_geteffectsvolume) - [`setEffectsVolume`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_seteffectsvolume) - [`getVolumeOfEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_getvolumeofeffect) - [`setVolumeOfEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_setvolumeofeffect) - [`setLocalVoicePitch`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch) - [`setLocalVoiceEqualization`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization) - [`setLocalVoiceReverb`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb) - [`setAudioEffectPreset`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset) - [`setVoiceBeautifierPreset`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset) - [`AudioEffectPreset`](/zh-CN/api-reference/rtc/harmonyos/enum-audioeffectpreset#enum_audioeffectpreset) - [`VoiceBeautifierPreset`](/zh-CN/api-reference/rtc/harmonyos/enum-voicebeautifierpreset#enum_voicebeautifierpreset) - [`onAudioRouteChanged`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-route#callback_irtcengineeventhandler_onaudioroutechanged) - [`startRecordingDeviceTest`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-device#api_iaudiodevicemanager_startrecordingdevicetest) - [`stopRecordingDeviceTest`](/zh-CN/api-reference/rtc/harmonyos/device-management/audio-device#api_iaudiodevicemanager_stoprecordingdevicetest) - [`muteRecordingSignal`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-capture#api_irtcengine_muterecordingsignal) - [`enableEncryptionEx`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengineex_enableencryptionex) - [`getNtpWallTimeInMs`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengine_getntpwalltimeinms) - [`setRemoteSubscribeFallbackOption`](/zh-CN/api-reference/rtc/harmonyos/network#api_irtcengine_setremotesubscribefallbackoption) - [`setAudioScenario`](/zh-CN/api-reference/rtc/harmonyos/audio/audio-basic#api_irtcengine_setaudioscenario) 新增 `CHATROOM` 和 `CHORUS` #### 修改 [#修改-13] - [`playEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_playeffect3) 和 [`preloadEffect`](/zh-CN/api-reference/rtc/harmonyos/play/audio-effect-file#api_irtcengine_preloadeffect) 改为异步方法,返回 `Promise` - [`VideoFrame`](/zh-CN/api-reference/rtc/harmonyos/class-videoframe#class_videoframe).`yStride` 更名为 `stride` - [`VideoFrame`](/zh-CN/api-reference/rtc/harmonyos/class-videoframe#class_videoframe).`buffer` 类型由 `ArrayBuffer | null` 变更为 `ArrayBuffer | undefined` - [`MediaPlayer`](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_imediaplayer) 支持打开 HarmonyOS 系统的 URL 和 URI #### 删除 [#删除-22] - [`LiveTranscoding`](/zh-CN/api-reference/rtc/harmonyos/class-livetranscoding#class_livetranscoding).`metadata` ## v4.4.2 [#v442] 该版本于 2024 年 11 月 29 日发布。 ### 升级必看 [#升级必看-60] - 该版本将访问区域(`areaCode`)的默认值从 `GLOB` 变更为 `CN`。 ### 新增特性 [#新增特性-86] - 该版本新增 `setEnableSpeakerphone` 方法,支持设置是否使用扬声器播放。 ### 问题修复 [#问题修复-104] 该版本修复了以下问题: - `isSpeakerphoneEnabled` 回调返回结果不准确。 - 在鸿蒙 NEXT 0.0.107 系统的设备上,调用 `leaveChannel` 后偶现崩溃。 ## v4.4.1 [#v441-1] 该版本于 2024 年 10 月 24 日发布,适配 HarmonyOS NEXT Release 版本,确保其在最新操作系统上的兼容性和性能表现。 ### 升级必看 [#升级必看-61] 该版本对 SDK 进行了以下优化和变更,为确保项目的正常运行,你需要在升级到该版本后更新 App 中的代码。 - 包名变更为 `@shengwang/rtc-full`(视频 SDK)或 `@shengwang/rtc-voice`(音频 SDK),请在添加依赖项和导入 SDK 组件的代码处修改包名,详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)或[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start)。 - HAR 包变更为字节码格式,你需要在 `build-profile.json5` 项目文件中增加以下编译选项: ```json "products": [ { "name": "default", "signingConfig": "default", "compatibleSdkVersion": "5.0.0(12)", "runtimeOS": "HarmonyOS", // highlight-start "buildOption": { "strictMode": { "useNormalizedOHMUrl": true } } // highlight-end } ], ``` ### 新增特性 [#新增特性-87] 该版本包含以下新增特性: - SDK 中包含 C/C++ 头文件,你可以在项目中直接使用 C/C++ 语言开发,无需另外拷贝。 - 支持内置媒体播放器和播放版权音乐功能。 ### 改进 [#改进-102] 该版本包含以下改进: - 提升了视频解码的流畅度。 - 优化了音频路由切换的体验。 - 提升了视频解码器的稳定性。 ### 问题修复 [#问题修复-105] 该版本修复了以下问题: - 音视频录制偶现崩溃。 - 偶现 `onVideSizeChanged` 回调无法正常上报。 ## v4.4.0 [#v440-5] 该版本于 2024 年 10 月 8 日发布。 #### 功能简介 [#功能简介] 该 SDK 由声网为开发者设计,旨在为鸿蒙系统的开发者提供简单且用户友好的实时互动解决方案。 SDK 提供了一套强大的 API,使开发者可以轻松构建具备实时音视频互动功能的应用程序,并可以利用鸿蒙系统的独特优势,增强应用的性能和用户体验。通过集成该 SDK,开发者可以快速实现高质量的音视频通话和互动直播等功能,提升应用的互动性和用户粘性。 #### 参考文档 [#参考文档] 你可以参考以下文档集成 SDK,实现相应的实时音视频功能: - [跑通 API 示例项目](/zh-CN/realtime-media/rtc/get-started/run-demo) - [实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start) - [实现极速直播](/zh-CN/realtime-media/rtc/build/advanced-channel/ls-quick-start) - [实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start) - [API 参考](/zh-CN/api-reference/rtc/harmonyos/rtc-api-overview) 声网提供了开源的[示例项目](https://gitee.com/agoraio-community/API-Examples/tree/main/HarmonyOS),你可以前往下载并体验。