设置音频属性

更新时间: 2024/09/09 11:38:42

NERoom SDK 默认使用标准音质模式语音场景。不同应用场景,对于音质、声道、噪声抑制等方面的要求各有不同,您可以根据 App 的场景,通过 setAudioProfile 设置音频属性,实现最优的音质效果。

功能描述

在不同的场景中,用户对于音质、声道、噪声抑制等方面的要求各有不同,例如在音乐直播、在线 KTV 等场景中,需要设置适宜于音乐场景的采样率、码率、流畅度、噪声抑制等参数和能力。NERoom 支持多种音频属性档位设置,适用于不同场景的音质、声道需求,以便您根据实际场景,方便快捷地调整音质属性、在常见场景中实现最优的音质效果。

通过 setAudioProfile 方法的 profile参数,配置音频 Profile 档位。

注意事项

  • 在初始化 NERoom 后,加入房间前或加入房间后,开启音频前均可调用setAudioProfile 接口。
  • 在 Chrome 浏览器中,如果有偶现的回声现象,建议使用 music_standard 或更高的音频档位配置,以实现更好的音质效果。

实现方法

通过 setAudioProfile 设置音频属性。

设置音频模式

profile 参数代表不同的音频参数配置(音质),比如采样率、码率和编码模式,包括:

音频 profile 类型 描述
speech_low_quality 低音质模式。16 kHz 采样率,单声道,编码码率约 24 Kbps。
speech_standard 语音标准音质模式。32 kHz 采样率,单声道,编码码率约 24 Kbps。
music_standard 音乐标准音质模式。48 kHz 采样率,单声道,编码码率约 40 Kbps。
standard_stereo 标准立体声模式。48 kHz 采样率,双声道,编码码率约 64 Kbps。
high_quality 高音质模式。48 kHz 采样率,单声道, 编码码率约 128 Kbps。
high_quality_stereo 高音质立体声模式。48 kHz 采样率,双声道,编码码率约 192 Kbps。

典型场景推荐配置

在语聊房、在线 K 歌、1 对 1 音视频通话、多人音视频通话、互动直播等典型场景下,云信推荐使用的音频参数配置如下表示所示。

业务场景
profile 设置
特性
游戏开黑 music_standard 在保证高音质的同时节省流量,频繁上下麦时不卡顿。
语聊房 high_quality 或 high_quality_stereo 音乐级高清音质,人声和背景音乐声音都有丰富的呈现,可搭配音效功能实现更有趣味性的体验。
在线KTV high_quality_stereo 高音质立体声,适用于音质要求较高的场景,还可以搭配丰富的音效增加娱乐效果。
互动直播 high_quality 高清音质。可根据实际直播场景选择单双声道。
音乐教学 high_quality_stereo 优先保证高清音质,音乐级音频能力。适用于对音质要求较高的场景。

示例代码

js/**
 * 获取房间上下文NERoomContext
 * @param roomUuid 房间ID
 */
const NERoomContext = NERoomService.getRoomContext(roomUuid)

/**
 * 设置音频属性
 * @param profile 音频属性
 */
NERoomContext.rtcController.setAudioProfile('music_standard').then(res => {
    console.log(res, 'setAudioProfile success')
}).catch(err => {
    console.error(res, 'setAudioProfile fail')
})

API 参考

方法 功能描述
setAudioProfile 设置音频编码配置,可以在加入房间后设置
setChannelProfile 设置房间场景
此文档是否对你有帮助?
有帮助
去反馈
  • 功能描述
  • 注意事项
  • 实现方法
  • 设置音频模式
  • 典型场景推荐配置
  • 示例代码
  • API 参考