The Agora SDK supports echo cancellation. In most cases, this problem can be fixed by using a headset, and ensure that the headset does not cause an echo.
In a channel joined by multiple users, if a device does not work properly, chances are that all other users in the channel can hear echoes. Therefore, beware that the user hearing the echo may not necessarily be the one having the problem.
Step 1: Self-check
Check the following:
- Check if the echo is occasional or continuous. An occasional echo may be caused by CPU overload. If the CPU usage is too high, voice recording and playback will be unstable. You can check this in Agora Analytics in Console.
- Ensure that all users are in separated physical environments.
- Check the SDK version:
- Android/iOS: v1.6.0+.
- Windows/macOS: v1.7.0+.
- Check if you enabled an external audio source. In this case, echo cancellation is not supported and the echo may be caused by data loss during the audio transmission to the SDK.
- In Windows, ensure the
Monitoring Microphoneoption is not checked.
- On iOS, ensure that the
Mixableoption is not enabled. If it is enabled and another app is using the microphone, echo may occur.
- On Android, check whether the app sets the
Game Streamingscenario in the
setAudioProfilemethod. In this scenario, echo cancellation is turned off by default.
- Use a headset:
- In a one-to-one call, if you hear an echo, ask the other user to use a headset.
- In a multi-user call, ask users to mute in turn to figure out who causes the echo. The users who cause the echo should use headsets or mute themselves.
Step 2: Contact Agora Customer Support
If the issue persists, contact Agora customer support and submit the issue with the following information:
|Mandatory||The name of the channel where the echo occurs.
The uids of the users who hear the echo.
The uid of the user who causes the echo.
The recording files, if available.
|Additional||The time frame during which the users hear the echo.
If the issue exists after rejoining the channel.
If the issue exists after the user causing or hearing the echo switches the audio route (such as using a headset).