Set audio properties

更新时间:
复制 MD 格式

The Real-Time Communication (RTC) software development kit (SDK) lets you set audio quality and scenarios. You can combine these settings to achieve the best product experience. This topic describes how to set audio properties.

Feature overview

The RTC SDK provides six audio quality modes (audio profiles) and five scenarios (audio scenes).

Table 1. Audio profile specifications
Enumeration valueNameChannels/Sample rate/Bitrate
AliRtcEngineLowQualityModeLow-quality audio mode1/8 kHz/12 kbps
AliRtcEngineBasicQualityModeStandard audio quality mode (default)1/16 kHz/24 kbps
AliRtcEngineHighQualityModeHigh-quality audio mode1/48 kHz/48 kbps
AliRtcEngineStereoHighQualityModeStereo high-quality audio mode2/48 kHz/64 kbps
AliRtcEngineSuperHighQualityModeSuper-high-quality audio mode1/48 kHz/96 kbps
AliRtcEngineStereoSuperHighQualityModeStereo super-high-quality audio mode2/48 kHz/128 kbps
Table 2. Audio scenes
Enumeration valueNameFeature
AliRtcSceneDefaultModeDefault scenarioRecommended for general RTC scenarios.
AliRtcSceneEducationModeEducation scenarioPrioritizes audio continuity and stability.
AliRtcSceneMediaModeMedia scenarioPreserves authentic human voice and music quality. Recommended for co-streaming in live channels.
AliRtcSceneMusicModeMusic scenarioHigh-fidelity music quality. Recommended for scenarios that require high music quality, such as musical instrument lessons.
AliRtcSceneChatRoomModeChat room modeSuitable for chat room scenarios without music.

Recommended parameter combinations

You can use the recommended parameter combinations or customize them for your business scenario. For example, in a co-streaming scenario, select the music scene if users plan to sing. Otherwise, select the media scene.

Business scenarioProfile settingScene settingAttribute
Regular voice chat roomStandard audio quality modeDefault scenarioGood audio quality and smooth transmission. Prioritizes call quality. Suitable for scenarios that do not require the highest audio quality.
Small-group voice-based classHigh-quality audio modeDefault scenarioHigh-definition audio quality and smooth transmission. Prioritizes call quality. Suitable for scenarios that require the highest voice quality.
Small-group musical instrument classHigh-quality audio modeMusic scenarioHigh-definition audio quality and smooth transmission. Prioritizes music quality. Suitable for scenarios that require the highest music quality.
Co-streaming - Voice chat onlyHigh-quality audio modeMedia scenarioHigh-definition audio quality and smooth transmission. Ensures voice quality and supports music. Suitable for chat scenarios with both voice and music.
Co-streaming - Voice chat & singingHigh-quality audio modeMusic scenarioHigh-definition audio quality and smooth transmission. Prioritizes music quality and provides various sound effects. Suitable for scenarios focused on singing and playing musical instruments, and for voice chat rooms that require high music quality.
Small wearable devices, such as phone watchesLow-power mode for audio qualityDefault scenarioGood audio quality, smooth transmission, high voice intelligibility, and low power consumption.

Implementation

You can use the following API operations to set the audio profile and scene:

PlatformAPIs for setting the audio profile and scene
AndroidsetAudioProfile
iOSsetAudioProfile
MacsetAudioProfile
WindowssetAudioProfile