互动直播 2.0
Android
动态与公告
更新日志(V4.6)
更新日志(V5)
活动与公告
【活动】内容安全检测限时补贴活动
新手接入指南
产品简介
产品介绍
功能特性
产品优势
应用场景
基本概念
使用限制
体验 Demo
下载 SDK 和 示例代码
升级指南
快速开始
接入流程
创建应用
开通服务
集成 SDK
实现互动直播
Token 鉴权
高级 Token 鉴权
基础功能
设置音频属性
设置视频属性
设置通话音量
屏幕共享
音频共享
监测发言者音量
通话中质量监测
进阶功能
音频管理
客户端音频录制
原始音频数据
美声变声与混响
耳返
自定义音频采集与渲染
音效与伴音
设置音频订阅优先级
音频裸流传输
视频管理
视频截图
水印
云信美颜
第三方美颜
自定义视频采集
视频图像畸变矫正
虚拟背景
视频裸流传输
设备管理
视频设备管理
音频设备管理
媒体补充增强信息
旁路推流
旁路推流
旁路推流画面布局
媒体流管理
跨房间媒体流转发
媒体流加密
视频流回退
AI 融合功能
AI 超分
AI 降噪
最佳实践
音视频参数配置推荐
客户端 API
Android API 参考
错误码
服务端 API
控制台指南
常见问题处理
FAQ
错题集
服务协议

设置音频属性

更新时间: 2023/04/23 17:09:48

NERTC SDK 支持设置音频编码属性设置,本文档为您介绍如何通过 setAudioProfile 方法的 profile 和 scenario 参数实现不同的音质效果。

功能描述

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

NERTC SDK 通过 setAudioProfile 方法的 profile 和 scenario 参数提供多种音频 Profile 档位和音频场景设置,您可以根据实际场景需求灵活调整音质属性。

注意事项

SDK 支持在加入房间通话中后,您根据实际场景变化动态调用 setAudioProfile 方法。

实现方法

通过 setAudioProfile 设置音频属性。

设置音频模式

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

音频 profile 类型 描述
DEFAULT 默认设置。语音场景下为 STANDARD,音乐场景下为 HIGH_QUALITY。
STANDARD 标准音质模式。采样率为 16 kHz、语音编码、单声道、编码码率最大值为 20 Kbps。
STANDARD_EXTEND 标准扩展模式。采样率为 16 kHz、语音编码、单声道、编码码率最大值为 32 Kbps。
MIDDLE_QUALITY 中等音质模式。采样率为 48 kHz、音乐编码、单声道、编码码率最大值为 64 Kbps。
MIDDLE_QUALITY_STEREO 中等音质模式(立体音)。采样率为 48 kHz、音乐编码、双声道、编码码率最大值为 80 Kbps。
HIGH_QUALITY 高音质模式。采样率为 48 kHz、音乐编码、单声道、编码码率最大值为 96 Kbps。
HIGH_QUALITY_STEREO 高音质模式(立体音)。采样率为 48 kHz、音乐编码、双声道、编码码率最大值为 128 Kbps。

设置音频场景

scenario 参数用于设置音频的使用场景,在不同场景中,声音的流畅度、噪声抑制、音质等会根据不同的场景做出优化。目前支持以下类型的场景:

scenario 场景 描述 音量
DEFAULT 默认的音频应用场景(语音)。 通话音量。
SPEECH 语音场景。推荐用于普通的音视频通话场景。 通话音量。
MUSIC 音乐场景。音乐级别音质设置,高保真、超流畅,推荐用于在线 KTV、在线演唱会、音乐直播、乐器教学等高音质要求的场景。 媒体音量。
CHATROOM 语音聊天室场景。优先保障音频连续性与稳定性,适用于用户需要频繁上下麦的场景。仅移动端支持。 通话音量。

不同的 scenario 下,设备的系统音量使用不同的音量类型。

参数搭配推荐

业务场景
profile 设置
scenario 设置
特性
游戏开黑 HIGH_QUALITY CHATROOM 在保证高音质的同时节省流量,频繁上下麦时不卡顿。
连麦时保留人声、减少杂音,适用于游戏语音场景。
语聊房(音乐场景) HIGH_QUALITY 或 HIGH_QUALITY_STEREO MUSIC 音乐级高清音质,人声和背景音乐声音都有丰富的呈现,可搭配音效功能实现更有趣味性的体验。
在线KTV HIGH_QUALITY_STEREO MUSIC 高音质立体声,适用于音质要求较高的场景,还可以搭配丰富的音效增加娱乐效果。
互动直播(音乐场景) HIGH_QUALITY 或 HIGH_QUALITY_STEREO MUSIC或CHATROOM 高清音质。可根据实际直播场景选择单双声道,音乐场景推荐使用MUSIC。
音乐教学 HIGH_QUALITY MUSIC 优先保证高清音质,音乐级音频能力。适用于对音质要求较高的场景。
  • 一对一通话
  • 语聊房(无音乐)
  • 互动直播(无音乐)
  • 多人通话/视频会议
  • 小班课/大班课
  • 双师课堂

STANDARD

SPEECH

在保证传输流畅的同时,维持高清音质,在弱网环境下优先保证通话稳定、流畅。SPEECH 模式下,回声、噪声等环境音过滤效果较好,可以提供更为清晰的人声语音效果。

示例代码

    NERtcEx.getInstance().setParameters(mRtcParameters); //先设置参数,后初始化
    try {
        NERtcEx.getInstance().init(getApplicationContext(),Config.APP_KEY,this,null);
    } catch (Exception e) {
        showToast("SDK初始化失败");
        finish();
        return;
    }
    NERtcEx.getInstance().setAudioProfile(mAudioProfile,mAudioScenario);//初始化后设置音频场景

API 参考

方法 功能描述
setAudioProfile 设置音频场景与模式,可以在加入房间后设置。
enableLocalAudio 开启/关闭本地语音采集和发送。
muteLocalAudio 开关本地音频发送。
subscribeRemoteAudioStream 订阅/取消订阅指定音频流。
subscribeAllRemoteAudioStreams 订阅/取消订阅所有用户音频,对后续加入的用户也同样生效。
此文档是否对你有帮助?
有帮助
我要吐槽
  • 功能描述
  • 注意事项
  • 实现方法
  • 设置音频模式
  • 设置音频场景
  • 参数搭配推荐
  • 示例代码
  • API 参考