Issue description
During real-time engagement, users may experience a total loss of sound in the following scenarios:
- The local user cannot hear remote users.
- A remote user cannot hear the local user.
- The local and remote users cannot hear each other.
Solution
Step 1: Determine the issue
To determine the issue, Agora recommends the local user and remote users do the following:
Open Agora Video Call, read the Agora Terms of Use and Privacy Policy carefully, and click Accept.
Enter the same channel name and password, enter a nickname, ensure that the microphone is enabled, and click Join.
Allow Agora Video Call to access the microphone, and start a conversation to check whether they can hear each other.
- If they can hear each other, proceed to step 5 to check the app logic.
- If they cannot hear each other, proceed to step 2 to check the audio input device.
On iOS, if a user equips a device with a non-Apple magnetic protection cover and cannot hear others, the issue may be caused by the protection cover. Remove the protection cover, leave the channel, and rejoin the channel to try whether the user can hear others.
Ensure that the audio input device is properly connected, and that the affected user has selected a suitable device when there are multiple device options.
In system settings, open the audio input device (or recording device) window. Ensure that the system uses a correct device and that the device is not muted.
Speak into the audio input device, and check whether the volume bar of the audio input device changes according to the volume.
- If the volume bar changes, the audio input device is working. Proceed to step 3 to check the audio output device.
- If the volume bar does not change, the audio input device is not working. Try restarting the device. If this does not help, try using another audio input device.
Step 3: Check the audio output device
- Ensure that the audio output device is properly connected, and that the affected user has selected a suitable device when there are multiple device options.
- In system settings, open the audio output device (or playback device) window. Ensure that the system uses a correct device and that the device is not muted.
- Play an audio file, and check whether the user can hear sound. If not, the audio output device is not working. Try restarting the device. If this does not help, try using another audio output device.
- If you use a sound card and cannot solve the issue after trying another audio output device, proceed to step 4 to check the sound card.
Step 4: Check the sound card
- Ensure the sound card is properly connected. If the user plays an audio file, ensure that the user enables the audio mixing function of the sound card.
- Reinstall the sound card driver, and check whether the user can hear sound. If not, the sound card is not working. Try replacing the sound card.
Step 5: Check the app logic
- Ensure that all users can access the correct audio devices.
- Check whether each user joins the channel successfully through the
onJoinChannelSuccess
/didJoinChannel
callback.
- Check whether the audio is muted by the
adjustRecordingSignalVolume(0)
, adjustPlaybackSignalVolume(0)
, or mute
-related methods.
- If a user uses headphones, check whether you call
setEnableSpeakerphone(false)
to route the audio to the headphones.
If the issue persists, contact Agora customer support and submit a ticket with the following information:
- The name of the channel where the users cannot hear sound.
- The user IDs of the users who cannot hear sound in the channel.
- The time frame during which the users cannot hear sound.
You can also use Agora Analytics in Console to gain a broad view of call issues for every user. See Agora Analytics Overview for details.