= Troubleshooting Sound Problems - pjsip.org =

Troubleshooting problems in the audio quality is one of the most difficult task to do with PJMEDIA, because mostly it is system specific. This page will try to provide a step-by-step troubleshooting guide to assist solving such problems.

== Understanding Media Flow ==

If you want to understand how audio is flowing among various PJMEDIA components, [wiki:media-flow the Understanding Media Flow page] provides a detailed explanation about this.



== Types of Problems ==

Please identify your problem with audio from the following list. If your problem is not listed below, it would be great to contact the mailing list so that I can add it here:

 1. [wiki:audio-problem-local-no-audio No audio is heard on local speaker during the call]
 1. [wiki:audio-problem-remote-no-audio No Audio is heard by remote party]
 1. [wiki:audio-problem-static-noise Loud static noise]
 1. [wiki:audio-problem-hissing-noise Soft/quiet noise ]
 1. [wiki:audio-problem-dropouts Audio drop-outs or "stutters"]
 1. [wiki:audio-problem-sending-tone Audio stutters when streaming tone to X-Lite/SJPhone]
 1. [wiki:audio-problem-remote-jitter High jitter value observed by remote party]

== All Checklists ==

For a thorough checks to your sound system you can follow these checklists:

 1. It's always recommended to check whether the problem exists with the latest SVN version of the libraries.
 1. [wiki:audio-check-correct-device Check that the correct device is being used].
 1. Check that no other application is using the devices. It is common to not be able to use sound device when the device is being used by other applications.
 1. [wiki:audio-check-loopback Check that speaker is functioning properly by Looping-back Microphone to Speaker device].
 1. [wiki:audio-check-play You can also check by Playing a WAV File to Speaker].
 1. [wiki:audio-check-rx-rtp Check that Incoming RTP Packets are Indeed Received by Local Host]
 1. [wiki:audio-check-conf-connection Check that the Call is Connected to the Sound Device in the Conference Bridge].
 1. [wiki:audio-check-cpu Check that CPU Utilization is not Too High]
 1. [wiki:audio-check-remote-address Check that pjsua is transmitting RTP packet to the correct address]
 1. [wiki:audio-check-codec-nego Check that codec is negotiated properly by both parties].
 1. [wiki:audio-check-ec Checking the Echo Cancellation Effectiveness]