In-ear monitoring provides a mix of the audio sources (for example, a mix of the vocals and music) to the host with low latency, commonly used in professional scenarios, such as in concerts.
The Agora SDK supports the in-ear monitoring function and volume adjustment of the in-ear monitor.


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

The Agora SDK provides the enableInEarMonitoring and setInEarMonitoringVolume methods to set the in-ear monitoring according to the scenario, you can use these methods no matter before or after joinChannel.

Sample code

// Enables in-ear monitoring. The default value is false.

// Sets the volume of the in-ear monitor. The value ranges between 0 and 100. The default value is 100, which represents the original volume captured by the microphone.
int volume = 80;

API reference


  • Call enableInEarMonitoring before setInEarMonitoringVolume.
  • The API methods have return values. If the method call fails, the return value is < 0.