Volume control and mute
This page shows you how to configure volume settings for audio recording, audio playback, and for the playback of music files.
Understand the tech
Agora Video SDK supports adjusting the audio volume for both recording and playback to meet practical application scenarios. For example, during a two-person call, you can mute a remote user by adjusting the playback volume setting to 0.
The figure below shows the workflow of adjusting the volume.
Playback refers to transmitting an audio signal from a sender to a recipient, where it is played back through a playback device.
In-ear monitoring refers to the process of playing audio captured by a device.
Recording refers to the process in which audio signals are captured by a recording device and then sent to the transmitter.
Prerequisites
Ensure that you have implemented the SDK quickstart in your project.
Implement volume control
Use one or more of the following volume control methods to adjust volume settings.
Adjust the playback volume
Call adjustPlaybackSignalVolume
or adjustUserPlaybackSignalVolume
to adjust the volume of the audio playback signal.
Adjust the in-ear monitoring volume
During the process of audio capture, mixing, and playback, Agora enables you to adjust the in-ear monitoring volume. Enable and set the volume using enableInEarMonitoring
and setInEarMonitoringVolume
.
Adjust the recording volume
Call adjustRecordingSignalVolume
to adjust the volume of the audio recording signal.
When configuring audio settings, it's essential to understand the default behavior and the options available. Here are the key points to keep in mind:
- The SDK defaults to a device volume of
85
when using the recording device to capture audio signals. - A volume of
0
means mute, and a volume of255
represents the maximum volume of the device. - If the SDK detects that the recording volume is too low in the current environment, it automatically increases the volume of the recording device.
- The volume of the recording device directly influences the global volume of the device.
- If the default recording device volume does not meet your requirements, adjust it by regulating the signal amplitude captured by the microphone or sound card.
Mute and unmute users
To mute or unmute the local audio stream, call muteLocalAudioStream
:
To mute or unmute a remote user, call muteRemoteAudioStream
with the uid
of the remote user:
Get volume information of users
Video SDK enables you to obtain the user IDs and corresponding volumes of the three users with the highest instantaneous volumes in a channel during the process of audio recording, mixing, and playback. You use the onAudioVolumeIndication
callback to obtain this information. A returned uid
of 0
in the callback indicates the local user.
enableAudioVolumeIndication
to enable reporting of the users' volume in the callback.Reference
This section contains content that completes the information on this page, or points you to documentation that explains other aspects to this product.
API reference
-
adjustRecordingSignalVolume
-
adjustPlaybackSignalVolume
-
adjustUserPlaybackSignalVolume
-
adjustAudioMixingPlayoutVolume
-
enableInEarMonitoring
[2/2] -
setInEarMonitoringVolume
-
onAudioVolumeIndication
-
muteLocalAudioStream
-
muteRemoteAudioStream
Sample projects
Agora offers the following open-source sample project for adjusting recording, playback, and in-ear monitoring volumes for your reference.
- GitHub: PlayAudioFiles