~ubuntu-branches/ubuntu/wily/sflphone/wily

« back to all changes in this revision

Viewing changes to daemon/libs/pjproject-2.2.1/doc/pjsip-book/media_quality.rst

  • Committer: Package Import Robot
  • Author(s): Jonathan Riddell
  • Date: 2015-01-07 14:51:16 UTC
  • mfrom: (4.3.5 sid)
  • Revision ID: package-import@ubuntu.com-20150107145116-yxnafinf4lrdvrmx
Tags: 1.4.1-0.1ubuntu1
* Merge with Debian, remaining changes:
 - Drop soprano, nepomuk build-dep
* Drop ubuntu patches, now upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
Media Quality
 
3
*************
 
4
 
 
5
Audio Quality
 
6
=============
 
7
If you experience any problem with the audio quality, you may want to try the steps below:
 
8
 
 
9
1. Follow the guide: `Test the sound device using pjsystest`_.
 
10
2. Identify the sound problem and troubleshoot it using the steps described in: `Checking for sound problems`_.
 
11
 
 
12
.. _`Checking for sound problems`: http://trac.pjsip.org/repos/wiki/sound-problems
 
13
.. _`Test the sound device using pjsystest`: http://trac.pjsip.org/repos/wiki/Testing_Audio_Device_with_pjsystest
 
14
 
 
15
It is probably easier to do the testing using lower level API such as PJSUA since we already have a built-in pjsua sample app located in pjsip-apps/bin to do the testing. However, you can also do the testing in your application using PJSUA2 API such as local audio loopback, recording to WAV file as explained in the Media chapter previously.
 
16
 
 
17
Video Quality
 
18
=============
 
19
For video quality problems, the steps are as follows:
 
20
 
 
21
1. For lack of video, check account's AccountVideoConfig, especially the fields autoShowIncoming and autoTransmitOutgoing. More about the video API is explained in `Video Users Guide`_.
 
22
2. Check local video preview using PJSUA API as described in `Video Users Guide-Video Preview API`_.
 
23
3. Since video requires a larger bandwidth, we need to check for network impairments as described in `Checking Network Impairments`_. The document is for troubleshooting audio problem but it applies for video as well.
 
24
4. Check the CPU utilization. If the CPU utilization is too high, you can try a different (less CPU-intensive) video codec or reduce the resolution/fps. A general guide on how to reduce CPU utilization can be found here: `FAQ-CPU utilization`_.
 
25
 
 
26
.. _`Video Users Guide`: http://trac.pjsip.org/repos/wiki/Video_Users_Guide
 
27
.. _`Video Users Guide-Video Preview API`: http://trac.pjsip.org/repos/wiki/Video_Users_Guide#VideopreviewAPI
 
28
.. _`Checking Network Impairments`: http://trac.pjsip.org/repos/wiki/audio-check-packet-loss
 
29
.. _`FAQ-CPU utilization`: http://trac.pjsip.org/repos/wiki/FAQ#cpu
 
30