设置音频属性
功能介绍
为了满足不同应用场景对音质、声道和实时性的不同需求,SDK提供可对音频参数,交互模式和场景模式进行组合配置的接口,根据自定义的搭配实现最佳效果。
实现方法
在设置音频属性前,请确保已在你的项目中实现 实现音视频互动。
在开播前,调用 setAudioConfig
可以设置音频属性,包括音质参数 profile
、交互模式 commuMode
和场景模式 scenarioMode
。
音质参数
属性(值) | 含义 |
THUNDER_AUDIO_CONFIG_DEFAULT(0) | 默认设置,通信模式下为 1,直播模式下为 3 |
THUNDER_AUDIO_CONFIG_SPEECH_STANDARD(1) | 采样率为 16 KHz,单声道,语音编码, 编码码率约 18 kbps SILK |
THUNDER_AUDIO_CONFIG_MUSIC_STANDARD_STEREO(2) | 采样率为 44.1 KHz,双声道,音乐编码, 编码码率约 24 kbps,编码延迟高,EAAC+ |
THUNDER_AUDIO_CONFIG_MUSIC_STANDARD(3) | 采样率为 48 KHz,单声道,音乐编码, 编码码率约 40 kbps,编码延迟低 |
THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO(4) | 采样率为 44.1KHz,双声道,音乐编码, 编码码率约 128kbps,AAC LC |
THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO_192(5) | 采样率为 44.1KHz,双声道,音乐编码, 编码码率约 192kbps,NET_AAC_192K |
THUNDER_AUDIO_CONFIG_SPEECH_STANDARD_PRO(6) | 编码格式为opus, 采样率16kHz,单声道,编码码率约18kbps |
THUNDER_AUDIO_CONFIG_MUSIC_STANDARD_PRO(7) | 编码格式为opus, 采样率48k,单声道,编码码率约40kbps |
THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO_PRO(8) | 编码格式为opus, 采样率48k,双声道,编码码率约128kbps |
THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO_192_PRO(9) | 编码格式为opus, 采样率48k,双声道,编码码率约192kbps |
交互模式
属性(值) | 含义 | 特性 |
THUNDER_COMMUT_MODE_DEFAULT(0) | 默认模式 | 等同于 THUNDER_COMMUT_MODE_HIGH(1) |
THUNDER_COMMUT_MODE_HIGH(1) | 强交互 | 连麦会自动切换为通话模式,使用通话音,适用于连麦后以通话为主的场景 |
THUNDER_COMMUT_MODE_LOW(2) | 弱交互 | 连麦继续保持原有的音频模式(媒体模式/通话模式),适用于连麦后以音乐为主的场景 |
场景模式
属性(值) | 含义 | 特性 |
THUNDER_SCENARIO_MODE_DEFAULT(0) | 默认模式 | 等同于 THUNDER_SCENARIO_MODE_STABLE_FIRST(1) |
THUNDER_SCENARIO_MODE_STABLE_FIRST(1) | 教育模式 | 流畅优先,保证音频连续性与稳定性,适用于教育场景,例如1对1互动教学 |
THUNDER_SCENARIO_MODE_QUALITY_FIRST(2) | 媒体模式 | 音质优先,保证原音音质,推荐对音乐音质有要求的场景使用。例如演唱会、纯音频互动等 |
推荐搭配
业务场景 | 特性 | 参数搭配 |
线上KTV | 高保真音质 | profile :THUNDER_AUDIO_CONFIG_SPEECH_STANDARD(1)
commuMode :THUNDER_COMMUT_MODE_LOW(2)
scenarioMode :THUNDER_SCENARIO_MODE_QUALITY_FIRST(2) |
游戏开黑 | 高保真音质、没有背景音乐需求 | profile :THUNDER_AUDIO_CONFIG_DEFAULT(0)
commuMode :THUNDER_COMMUT_MODE_HIGH(1)
scenarioMode :THUNDER_SCENARIO_MODE_QUALITY_FIRST(2) |
PK连麦 | 在保证高清音质的同时,保证传输流畅性 | profile :THUNDER_AUDIO_CONFIG_MUSIC_STANDARD
commuMode :THUNDER_COMMUT_MODE_HIGH
scenarioMode :THUNDER_SCENARIO_MODE_QUALITY_FIRST(2) |
在线教育 | 流畅优先、保证音频连续性与稳定性 | profile : THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO
commuMode :THUNDER_COMMUT_MODE_HIGH
scenarioMode :THUNDER_SCENARIO_MODE_STABLE_FIRST(1) |