Adjust the Volume

The Agora Video SDK enables you to manage the volume of the recorded audio or of the audio playback according to your actual scenario. For example, to mute a remote user in a one-to-one call, you can set the audio playback volume as 0.

This article provides the APIs and additional information relating to audio recording, audio mixing, audio playback and in-ear monitoring volume settings.

We provide an open-source AdjustVolume sample project that implements adjusting the sampling, playback, and ear-monitoring volume on GitHub. You can download the sample project and view the source code.

Before adjusting the audio volume, ensure that you have implemented the basic real-time communication functions in your project. For details, see Start a Call or Start Interactive Live Streaming.

Recording is the process of sampling audio by a recording device and transmitting the recorded signal to the sender. To adjust the recording volume, you can set the volume of the recorded signal.

Call adjustRecordingSignalVolume to set the volume of the recorded signal. The volume parameter represents the audio level of the recorded signal, which ranges between 0 and 100:

• 0: Mute.
• 100: (Default) The original volume.

_3

int volume = 50;

_3

// Sets the volume of the recorded signal.

_3

rtcEngine.adjustRecordingSignalVolume(volume);

• adjustRecordingSignalVolume

Playback is the process of playing the received audio signal on the local playback device. To adjust the playback volume, you can set the volume of the audio signal.

You can use adjustPlaybackSignalVolume or adjustUserPlaybackSignalVolume to set the volume of the audio signal.

• adjustPlaybackSignalVolume：
  • Universally sets the playback audio level of all remote users after audio mixing.
  • The volume parameter represents the playback audio level, which ranges between 0 and 400.
• adjustUserPlaybackSignalVolume：
  • Adjusts the playback audio level of a specified remote user after audio mixing. Call this method as many times as necessary to adjust the playback volume of different remote users, or to repeatedly adjust the playback volume of the same remote user.
  • The volume parameter represents the playback audio level, which ranges between 0 and 100.

As of v2.3.2, to mute the local audio playback, you must call both adjustPlaybackSignalVolume and adjustAudioMixingVolume, and set the volume parameter as 0.

Call adjustUserPlaybackSignalVolume after joining a channel.

_5

int volume = 50;

_5

// Sets the playback audio level of all remote users.

_5

rtcEngine.adjustPlaybackSignalVolume(volume);

_5

// Sets the playback audio level of a specified remote user.

_5

rtcEngine.adjustUserPlaybackSignalVolume(uid, volume);

• adjustPlaybackSignalVolume
• adjustUserPlaybackSignalVolume
• adjustAudioMixingPlayoutVolume

In audio recording, mixing and playing, you can call setInEarMonitoringVolume to adjust the volume of the in-ear monitoring.

The volume parameter represents the volume of the in-ear monitoring, ranging between 0 and 100.

• 0: Mute.
• 100: (Default) The original volume.

_5

// Enables in-ear monitoring.

_5

rtcEngine.enableInEarMonitoring(true);

_5

int volume = 50;

_5

// Sets the in-ear monitoring volume.

_5

rtcEngine.setInEarMonitoringVolume(volume);

• setInEarMonitoringVolume

When recording, mixing, or playing audio, you can use the following methods to get the data of the loudest speaker in the channel.

• Reports users with the highest peak volumes. The onAudioVolumeIndication callback reports the user IDs the corresponding volumes of the currently loudest speakers in the channel.

  You must call enableAudioVolumeIndication to be able to receive this callback.

Sample code

_5

// Gets the the user IDs of the users with the highest peak volume, the corresponding volumes, as well as whether the local user is speaking.

_5

// @param speakers is an array containing the user IDs and volumes of the local and the remote users. The volume parameter ranges between 0 and 255.

_5

// @param totalVolume refers to the total volume after audio mixing, ranging between 0 and 255.

_5

public void onAudioVolumeIndication(AudioVolumeInfo[] speakers, int totalVolume) {

_5

}

• Reports the user with the highest average volume. The onActiveSpeaker callback reports the user ID with the highest average volume during a certain period of time.

  You must call enableAudioVolumeIndication to be able to receive this callback.

Sample code

_3

// Gets the user ID of the user with the highest average volume during a certain period of time.

_3

public void onActiveSpeaker(int uid) {

_3

}

• onAudioVolumeIndication
• onActiveSpeaker

Setting the audio level too high may cause audio distortion on some devices.

When adjusting the audio volume, you can also refer to the following articles:

• How to solve the problem of low volume?