跳到主要内容

音量

本文介绍如何设置音频采集音量、耳返播放的音量以及如何对播放音频进行静音。

本文不介绍混音音量控制。请另行参见「混音」文档。

设置采集音量

采集是指音频信号由采集设备(麦克风)采集,然后传输到发送端的过程。App 可通过 RCRTCMicOutputStreamadjustRecordingVolume 设置麦克风为音频源的音频输出流音量大小。

  • 如果 SDK 版本 < 5.3.4,采集音量大小范围为 0-100。默认 100。
  • 如果 SDK 版本 ≧ 5.3.4,采集音量大小范围为 0-200。默认 100。
/**
* 调整音量
*
* @group 音频配置
* @param volume 0-200
*/
void adjustRecordingVolume(int volume);

App 需要调用 RCRTCEngine 下的 getDefaultAudioStream 方法,获取 RCRTCMicOutputStream 对象或可进行设置:

RCRTCEngine.getInstance().getDefaultAudioStream().adjustRecordingVolume(150);

设置耳返音量

提示

SDK 从 5.3.2 版本开始支持设置耳返音量。

耳返是指播放采集设备输出音频的过程。SDK 内置了耳返功能,同时也支持在部分机型使用原厂自带的耳返功能。关于如何启用耳返功能,详见设备管理下「麦克风」文档。

SDK 从 5.3.2 版本开始,支持通过麦克风输出流对象 RCRTCMicOutputStreamsetEarMonitoringVolume 方法设置耳返音量。如设备上使用原厂耳返功能,则该方法会设置原厂耳返的音量。

App 需要调用 RCRTCEngine 下的 getDefaultAudioStream 方法,获取 RCRTCMicOutputStream 对象后可进行设置。音量取值范围 0 ~ 100。

// 设置耳返音量
RCRTCEngine.getInstance().getDefaultAudioStream().setEarMonitoringVolume(100);

设置播放音量

  • 如果 SDK 版本 < 5.3.4,不支持设置播放音量值,仅支持设置指定或全部远端音频流为静默状态,实现静音效果。
  • 如果 SDK 版本 ≧ 5.3.4,可调节远端播放音量。

调节远端播放音量

提示

SDK 从 5.3.4 版本开始支持调节远端播放音量。

从 5.3.4 开始,App 可以调用 RCRTCEngine 下的 adjustRemotePlaybackVolume 方法调节远端播放音量。音量范围为 [0-200],0 表示静音。加入房间前后均可调节音量。该方法调节的是本地播放的所有远端用户混音后的音量。

// 调节远端播放音量
RCRTCEngine.getInstance().adjustRemotePlaybackVolume(150);

int currentVolume = RCRTCEngine.getInstance().getRemotePlaybackVolume();

静音本地音频流

媒体流对象都可以调用 RCRTCStream 接口提供的 mute(boolean mute) 方法设置是否静默。

对于本地音频流,如果 mute 为 true 则不再发送本地资源,也不能播放,但不影响音频数据采集。

RCRTCEngine.getInstance().getDefaultAudioStream().mute(mute);

静音远端音频流

媒体流对象都可以调用 RCRTCStream 接口提供的 mute(boolean mute) 方法设置是否静默。

对于远端音频流,如果 mute 为 true 则不再播放远端音频,但不影响远端音频数据接收。

for (RCRTCInputStream inputStream : inputStreams) {
if (inputStream.getMediaType() == RCRTCMediaType.AUDIO){
RCRTCAudioInputStream audioInputStream = (RCRTCAudioInputStream) inputStream;
audioInputStream.mute(true);
}
}

静音房间内全部远端音频流

App 需要在用户加入房间后,在当前房间对象 RCRTCRoom 上调用 muteAllRemoteAudio,设置为 true 不再播放远端音频流。默认不开启。