设置音频属性

本文介绍 音视频SDK 提供的设置音频属性功能以及实现方法。

1 功能介绍

为了满足不同应用场景对音质、声道和实时性的不同需求,SDK提供可对音频参数,交互模式和场景模式进行组合配置的接口,根据自定义的搭配实现预期效果。

2 实现方法

设置音频属性

使用 setAudioConfig 可以设置音频属性,包括音频参数、交互模式和场景模式:

音频参数

  • THUNDER_AUDIO_CONFIG_DEFAULT(0):默认设置。通信模式下为 1,直播模式下为 2
  • THUNDER_AUDIO_CONFIG_SPEECH_STANDARD(1):指定 16 KHz采样率,语音编码, 单声道,编码码率约 18 kbps
  • THUNDER_AUDIO_CONFIG_MUSIC_STANDARD_STEREO(2):指定 44.1 KHz采样率,音乐编码, 双声道,编码码率约 24 kbps,编码延迟高
  • THUNDER_AUDIO_CONFIG_MUSIC_STANDARD(3):指指定 44.1 KHz采样率,音乐编码, 单声道,编码码率约 40 kbps,编码延迟低
  • THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO(4):指定 44.1KHz采样率,音乐编码, 双声道,编码码率约 128kbps
  • THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO_192(5); 指定 44.1KHz采样率,音乐编码, 双声道,编码码率约 192kbps

交互模式

  • THUNDER_COMMUT_MODE_DEFAULT(0):默认=1
  • THUNDER_COMMUT_MODE_HIGH(1):强交互模式
  • THUNDER_COMMUT_MODE_LOW(2):弱交互模式

场景模式

  • THUNDER_SCENARIO_MODE_DEFAULT(0):默认=1
  • THUNDER_SCENARIO_MODE_STABLE_FIRST(1):流畅优先:推荐注重稳定的教育
  • THUNDER_SCENARIO_MODE_QUALITY_FIRST(2):音质优先:推荐很少或者不连麦的秀场
//FM 高品质
thunderEngine.setAudioConfig(
    THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO,
    THUNDER_COMMUT_MODE_LOW,
    THUNDER_SCENARIO_MODE_QUALITY_FIRST
);

// 游戏开黑场景
thunderEngine.setAudioConfig(
    THUNDER_AUDIO_CONFIG_SPEECH_STANDARD,
    THUNDER_COMMUT_MODE_HIGH,
    THUNDER_SCENARIO_MODE_STABLE_FIRST
);

// 娱乐场景
thunderEngine.setAudioConfig(
    THUNDER_AUDIO_CONFIG_MUSIC_STANDARD,
    THUNDER_COMMUT_MODE_HIGH,
    THUNDER_SCENARIO_MODE_STABLE_FIRST
);

// KTV
thunderEngine.setAudioConfig(
    THUNDER_AUDIO_CONFIG_MUSIC_HIGH_QUALITY_STEREO,
    THUNDER_COMMUT_MODE_HIGH,
    THUNDER_SCENARIO_MODE_STABLE_FIRST
);

3 API参考

4 注意事项

  • setAudioConfig 需要在 joinRoom 之前调用。
  • 接口返回值:方法调用成功返回 0,失败返回 < 0。
<