Skip to main content

You are looking at Interactive Live Streaming v3.x Docs. The newest version is  Interactive Live Streaming 4.x

Android
iOS
macOS
Windows C++
Windows C#
Unity
Flutter
React Native
Electron
Cocos Creator
Cocos2d-x

Adjust the Volume

Introduction

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.

1578559042677

Sample project

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.

Implementation

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.

Adjust the recording volume

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.

1578559122611

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.

Sample code


_3
int volume = 50;
_3
// Sets the volume of the recorded signal.
_3
rtcEngine.adjustRecordingSignalVolume(volume);

API reference

Adjust the playback volume

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.

1578559415146

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.
  • Sample code


    _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);

    API reference

    Adjust the in-ear monitoring volume

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

    1578560373700

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

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

    Sample code


    _5
    // Enables in-ear monitoring.
    _5
    rtcEngine.enableInEarMonitoring(true);
    _5
    int volume = 50;
    _5
    // Sets the in-ear monitoring volume.
    _5
    rtcEngine.setInEarMonitoringVolume(volume);

    API reference

    Get the data of the loudest speaker (callback)

    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
    }

    API reference

    Considerations

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

    Reference

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

    Interactive Live Streaming