功能描述

在一些比较专业的场景里,用户对声音的效果尤为敏感,比如语音电台,此时就需要对双声道和高音质的支持。
所谓的高音质指的是我们提供采样率为 48 Khz、码率 192 Kbps 的能力,帮助用户实现高逼真的音乐场景,这种能力在语音电台、唱歌比赛类直播场景中应用较多。

本文指导开发者根据对音质、声道、场景等的不同需求,选择不同的音频属性,获得最佳实时互动效果。

实现方法

Agora SDK 提供 setAudioProfile 方法给开发者根据场景需求灵活配置适合的音质属性。这个方法有 2 个参数:

参数 描述
profile 代表不同的音频参数配置(音质),比如采样率、码率和编码模式等:
  • AUDIO_PROFILE_DEFAULT(0):默认设置。通信模式下为 SPEECH_STANDARD(1),直播模式下为 MUSIC_STANDARD(2)
  • AUDIO_PROFILE_SPEECH_STANDARD(1):指定 32 kHz 的采样率,语音编码,单声道,编码码率最大值为 18 kbps
  • AUDIO_PROFILE_MUSIC_STANDARD(2):指定 48 kHz 的采样率,音乐编码,单声道,编码码率最大值为 48 kbps
  • AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3):指定 48 kHz 的采样率,音乐编码,双声道,编码码率最大值为 56 kbps
  • AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4):指定 48 kHz 的采样率,音乐编码,单声道,编码码率最大值为 128 kbps
  • AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5):指定 48 kHz 的采样率,音乐编码,双声道,编码码率最大值为 192 kbps
  • scenario 设置音频的使用场景,如娱乐、教学和游戏直播等。声音的流畅度、噪声抑制、音质等会根据不同的场景做出优化:
  • AUDIO_SCENARIO_DEFAULT(0):默认的音频应用场景
  • AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT(1):娱乐应用,适用于需要频繁上下麦的场景
  • AUDIO_SCENARIO_EDUCATION(2):教育场景
  • AUDIO_SCENARIO_GAME_STREAMING(3):游戏直播以及高音质互动应用,音质优先,适用于聊天房唱歌表演的场景
  • AUDIO_SCENARIO_SHOWROOM(4):秀场应用,连麦下音质仅次于 GAME_STREAMING,拥有更好的专业外设支持
  • AUDIO_SCENARIO_CHATROOM_GAMING(5):游戏应用,适用于游戏开黑场景,如吃鸡
  • 参数搭配

    你可以参考下图,根据应用场景对音质、设备的不同需求,选择不同的参数搭配。

    参数 场景需求 选项
    profile 高音质
  • MUSIC_HIGH_QUALITY
  • MUSIC_HIGH_QUALITY_STEREO
  • 有一定音质要求
  • MUSIC_STANDARD
  • MUSIC_STANDARD_STEREO
  • 对音质无要求
  • DEFAULT
  • SPEECH_STANDARD
  • scenario 音质/音效优先 GAME_STREAMING
    频繁上下麦 CHATROOM_ENTERTAINMENT
    支持外放设备 SHOWROOM
    开黑少杂音 CHATROOM_GAMING
    传输质量稳定 DEFAULT

    也可以根据下表中提供的场景,直接选择参数进行搭配。

    场景 profile scenario 特性
    1 v 1 小班课 DEFAULT DEFAULT 传输流畅、音质高清,优先保证通话质量
    游戏开黑 SPEECH_STANDARD CHATROOM_GAMING 只保留语音,非语音部分(键盘声、外放音乐等)不会被传输。节省码率的同时减少杂音,适合多人团战
    剧本杀 MUSIC_STANDARD CHATROOM_ENTERTAINMENT 优秀的音乐编解码技术,提供更为丰富的声音呈现。上下麦没有音量、音质变化
    KTV 练歌房 MUSIC_HIGH_QUALITY GAME_STREAMING 高音质搭配丰富音效,适用于对音质要求高的场景
    语音电台 MUSIC_HIGH_QUALITY_STEREO SHOWROOM 高音质,立体声,支持专业外放设备
    音乐教学 MUSIC_STANDARD_STEREO GAME_STREAMING 优先保证音质。适用于外放音效也能直播出去的场景
    双师课堂 MUSIC_STANDARD_STEREO CHATROOM_ENTERTAINMENT 保证音质的同时,呈现更丰富的声音效果。上下麦没有音量、音质变化

    示例代码

    // FM 高音质
    rtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO, Constants.AUDIO_SCENARIO_SHOWROOM);
    
    // 游戏开黑场景
    rtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_SPEECH_STANDARD, Constants.AUDIO_SCENARIO_CHATROOM_GAMING);
    
    // 娱乐场景
    rtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_STANDARD, Constants.AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT);
    
    // KTV
    rtcEngine.setAudioProfile(Constants.AUDIO_AUDIO_PROFILE_MUSIC_HIGH_QUALITY, Constants.AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT);

    API 参考

    开发注意事项

    不同的 Audio scenario 下,设备的系统音量是不同的。

    系统音量分通话音量和媒体音量两种:

    • 通话音量指的是进行语音、视频通话时的音量。通话音量有较好的回声消除。
    • 媒体音量指的是播放音乐、视频或游戏的音效、背景音的音量。媒体音量有较好的声音表现力。

    两者的差异在于媒体音量可以调整到 0,而通话音量不可以。

    SDK 在 setAudioProfile 中提供 6 种不同的 Audio scenario,其中不同的 Audio scenario 使用的音量不同。如果需要将音量调整到 0,建议使用媒体音量控制的 Audio scenario。

    Audio scenario 音量
    GAME_STREAMING 媒体音量
    DEFAULT
  • 通信模式下,所有用户使用通话音量
  • 直播模式下,主播及连麦主播使用通话音量,观众使用媒体音量
  • EDUCATION
    SHOWROOM
    CHATROOM_ENTERTAINMENT 通话音量
    CHATROOM_GAMING 通话音量