跳到主要内容

音量

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

本文不包含混音音量控制。请参见混音文档。

设置采集音量​

采集指音频信号由采集设备（麦克风）采集后传输到发送端的过程。您可以通过 RCRTCMicOutputStream 的 adjustRecordingVolume 设置麦克风为音频源的音频输出流音量大小。

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

调用 RCRTCEngine 的 getDefaultAudioStream 获取 RCRTCMicOutputStream 对象后进行设置：

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

设置耳返音量​

提示

SDK 自 5.3.2 版本起支持设置耳返音量。

耳返指播放采集设备输出音频的过程。SDK 内置耳返能力，同时也支持在部分机型使用原厂自带的耳返功能。启用耳返的方法参见“设备管理”下的“麦克风”文档。

从 5.3.2 版本起，可通过麦克风输出流对象 RCRTCMicOutputStream 的 setEarMonitoringVolume 设置耳返音量；若设备使用原厂耳返，该方法将设置原厂耳返音量。 App 需要调用 RCRTCEngine 下的 getDefaultAudioStream 方法，获取 RCRTCMicOutputStream 对象后可进行设置。音量取值范围 0 ~ 100。

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

设置播放音量​

  • 如果 SDK 版本 < 5.3.4，不支持设置播放音量，仅支持将指定或全部远端音频流设为静音。实现静音效果。
  • 如果 SDK 版本 ≥ 5.3.4，支持调节远端播放音量。

调节远端播放音量​

提示

SDK 自 5.3.4 版本起支持调节远端播放音量。

调用 RCRTCEngine 的 adjustRemotePlaybackVolume 调节远端播放音量，范围 0 ~ 200（0 表示静音）。加入房间前后均可调用。该方法调节的是本地播放的“所有远端用户混音后”的整体音量。

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

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

静音本地音频流​

所有媒体流对象均可调用 RCRTCStream 的 mute(boolean mute) 设置是否静音。

对于本地音频流，mute = true 时不再发送本地资源，也不能播放，但不影响音频数据采集。

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

静音远端音频流​

所有媒体流对象均可调用 RCRTCStream 的 mute(boolean mute) 设置是否静音。

对于远端音频流，mute = true 时不再播放远端音频，但不影响远端音频数据接收。

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

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

加入房间后，可在当前房间对象 RCRTCRoom 上调用 muteAllRemoteAudio(true) 不再播放房间内的远端音频流（默认不开启）。

最后于 更新