wiki:sound-problems
Last modified 3 years ago Last modified on 04/16/12 18:23:58

Troubleshooting Sound Problems - pjsip.org

Troubleshooting problems in the audio quality is one of the most difficult task to do with PJMEDIA, because not only it is system/usage specific but also sometimes it is quite hard to describe what the problem is. 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, the Understanding Media Flow page provides a detailed explanation about this.

Types of Problems

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

  1. No audio is heard on local speaker during the call
  2. No Audio is heard by remote party
  3. Audio breakups
  4. Audio drop-outs or "stutters"
  5. Loud static noise
  6. Soft/quiet noise
  7. Audio stutters when streaming tone to X-Lite/SJPhone
  8. High jitter value observed by remote party

How to Report Audio Problems

If the problem is not listed above, or a solution can't be found, then the next step is to try to contact the mailing list to see if members can provide some help to diagnose/solve the problems. When reporting the problem, it's always good to follow this guideline:

  • Try to describe the problem in detail (is it noise, stutters, etc). Be verbose, because certainly it doesn't help at all to say that "the audio is bad" without describing what it means.
  • Let others know what checklists have been done. Try to narrow down the problem. If there are some log output (such as output of pjsua's dq command or sndtest output or just pjsua's log file) then attach these outpus to your post. It's always better to have more data rather than less data.
  • It will be very useful to have a sample recording of the problem, if it is possible. We know that it's very hard to describe what something sounds like, so with a recording others can hear themselves what exactly the problem is. Use the How to Record Audio with pjsua page for some instructions. Note that the mailing list does not allow message larger than 100 KB so probably you'd need to put the sample recording somewhere and provide the link to your post.