manual.sgml

linphone源码-1.3.5.tar.gz,linphone源码-1.3.5.tar.gz

   </listitem>

   </itemizedlist>

   </sect2>

   <sect2 id="paramaudio">
    <title>
Audio parameters
   </title>
   <para>
In this section you will find parameters related to your sound equipment.
   </para>
   <itemizedlist>
    <listitem>
    <para>
Sound card choice: if you have several soundcards on your pc, you can select the one to be used by linphone.
    </para>

   </listitem>
    <listitem>
    <para>
Source choice: in this combo box you can choose the recording source for your voice. In most case it will be the microphone (mic).
    </para>

   </listitem>

   </itemizedlist>

   </sect2>


  </sect1>

  <sect1>
   <title>
Address book
  </title>
  <para>
The address book let you store and recall name and sip addresses of people. 
  </para>
  <para>
When adding a new contact, a little contact box is displayed in where you are prompted for information about the person, mainly of course his sip address. Additionnaly you can toggle the &ldquo;send subscription&rdquo; button to ask the person to keep you informed of his online status (ready, busy, gone...). You can also choose to reject subscription from this person, meaning that he will not be informed of your online status.
  </para>

  </sect1>

  <sect1>
   <title>
Using sip proxies and registrar.
  </title>
  <para>
Registering on a SIP server can be usefull in two main cases:
  </para>
  <itemizedlist>
   <listitem>
   <para>
Your machine does not have a public domain name, which prevents other users to call you as they can't guess your IP address. In this case, you can register to a proxy or redirect sip server to get a public sip address. For example, you are &lt;sip:bob@no-host-name&gt; and let's suppose it exists a redirect or proxy sip server at &lt;sip:myserver.org&gt;. By registering to &lt;sip:myserver.org&gt;, your friends will be able to call you at the address &lt;sip:[e-mail]&gt; . The proxy or redirect server myserver.org will forward or redirect the calls from your friends to your exact location.
   </para>

  </listitem>
   <listitem>
   <para>
You are behind a firewall. In order for UDP messages (SIP and RTP are on top of UDP) to go through the firewall correctly, in most cases a SIP proxy running on the firewall machine is necessary. You must indicate to linphone the proxy to be used, and tell it that this proxy is an outbound proxy (ie all messages must go through it).
   </para>

  </listitem>

  </itemizedlist>
  <para>
With linphone&gt;=1.0.0 you can choose to use several proxies simultaneously. Go to the property box, section sip, and click on add proxy. You'll be prompted for proxy address, route and your identity (also known as address of record). This information should be given to you by your sip provider you registered to. Route can be optionnal, so leave it empty in case you don't know what to put here. The identity is the sip address you are known by the proxy. Other users on the network are supposed to always be able to find you at this sip address.
  </para>

  </sect1>

  <sect1>
   <title>
Behind a firewall
  </title>
  <para>
Linphone is now able to work behind firewalls using a SIP proxy server. A SIP proxy server is responsible to forward calls from the private network to the external network, and vice versa. Two sip proxy based on oSIP library are being developed at <ulink url="http://siproxd.sourceforge.net">http://siproxd.sourceforge.net</ulink> and <ulink url="http://www.partysip.org">http://www.partysip.org</ulink>. The setup of each of those sip proxies is outside the scope of this document. Please refer to their website.
  </para>
  <para>
There is one case where a sip proxy is not needed: when you are in a network where your machine has a public address and the firewall is just here to filter incoming and outgoing packets from the external network. In this case, all you have to do is to open the SIP port and RTP port on the firewall machine. The SIP port is given in the property box, section SIP, and the RTP port is given in the property box, section RTP. Both can be changed, but it es strongly recommended you to let the SIP port unchanged (5060).
  </para>

  </sect1>

  <sect1>
   <title>
Problems
  </title>
   <sect2>
    <title>
Connection problems
   </title>

   </sect2>

   <sect2>
    <title>
Audio problems
   </title>
   <blockquote>
   <para>
Linphone seems to connect to the remote sip url, it rings, but when the callee answers, nothing happens and we can't hear each other.
   </para>

   </blockquote>
   <itemizedlist>
    <listitem>
    <para>
First rise up playback and recording level.
    </para>

   </listitem>
    <listitem>
    <para>
If the voice is sometines cutted, you can modify parameter RTP-&gt;jitter compensation in the property box to greater values to avoid this. But it increases the delay transmission.
    </para>

   </listitem>
    <listitem>
    <para>
If linphone cannot open the audio device, check if it has the permission to open /dev/dsp, close all programs able to use audio device (xmms, kaiman...).
    </para>

   </listitem>
    <listitem>
    <para>
Use alsa drivers (see <ulink url="http://www.alsa-project.org">http://www.alsa-project.org</ulink>). Most distributions still use the old oss kernel-official drivers, that have big latency problems and are often buggy. ALSA drivers are much better. 
    </para>

   </listitem>

   </itemizedlist>

   </sect2>


  </sect1>

  <sect1>
   <title>
Bugs reporting and suggestions
  </title>
  <para>
First go to linphone's home page at <ulink url="http://www.linphone.org">http://www.linphone.org</ulink> to check if you have the latest version if linphone.
  </para>
  <para>
If linphone crashes, send a report to the mailing list, [e-mail]. If linphone does not work, but does not crash, please ensure you have read all this manual before sending me a bug report at the above address. If you want to request something, don't hesitate to send me an email to the mailing list too. Note that video support, and conferencing are planned features. If someone is interested in doing translations for linphone, send me a xx.po file based on the po/linphone.pot file of the distribution. You can also translate this user manual in other languages. In any case, please contact me if you want more details.
  </para>

  </sect1>

  <sect1>
   <title>
Authors
  </title>
  <para>
Simon MORLAT ([e-mail]) wrotes: 
  </para>
  <itemizedlist>
   <listitem>
   <para>
main library (coreapi)
   </para>

  </listitem>
   <listitem>
   <para>
gnome interface (thanks to glade !)
   </para>

  </listitem>
   <listitem>
   <para>
RTP library (oRTP)
   </para>

  </listitem>
   <listitem>
   <para>
audio/video framework and wrappers (mediastreamer)
   </para>

  </listitem>

  </itemizedlist>
  <para>
Aymeric Moizard ([e-mail]) wrotes the osip and eXosip stacks that is used by linphone. 
  </para>
  <para>
The speex codec <ulink url="http://www.speex.org">http://www.speex.org</ulink> is a high quality low bitrate codec by Jean Marc Valin.
  </para>
  <para>
The GSM library was written by : Jutta Degener and Carsten Bormann,Technische Universitaet Berlin.
  </para>
  <para>
The LPC10-1.5 library was written by: Andy Fingerhut Applied Research Laboratory &lt;-- this line is optional if Washington University, Campus Box 1045/Bryan 509 you have limited space One Brookings Drive Saint Louis, MO 63130-4899 [e-mail] http://www.arl.wustl.edu/&tilde;jaf/ See text files in gsmlib and lpc10-1.5 directories for further information.
  </para>
  <para>
Icons by Pablo Marcelo Moia.
  </para>

  </sect1>

  <sect1>
   <title>
Thanks
  </title>
  <para>
Thanks to Daemon Chaplin, for having done Glade, the gtk interface builder.
  </para>
  <para>
Thanks to Aymeric Moizard, for his famous oSIP library.
  </para>
  <para>
Thanks to Florian Winstertein, for the console interface of linphone.
  </para>
  <para>
Thanks to Jean Marc Valin, for his great speex codec.
  </para>
  <para>
Thanks to the authors of LPC10-1.5 and GSM code.
  </para>
  <para>
Thanks to Joel Barrios ( [e-mail] ) for his RPMS.
  </para>
  <para>
Thanks to Pablo Marcelo Moia for the great icons he has made for linphone.
  </para>
  <para>
<toc></toc>
  </para>

  </sect1>




</article>