1
<?xml version="1.0" encoding="utf-8" standalone="no"?>
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
<!ENTITY appversion "3.00">
5
<!ENTITY manrevision "3.00">
8
<article id="index" lang="fi">
10
<title><application>Ekigan</application> ohjekirja 3.00</title>
12
<copyright><year>2003-2008</year><holder>Damien Sandras</holder></copyright>
13
<copyright><year>2003-2004</year><holder>Matthias Redlich</holder></copyright>
14
<copyright><year>2003-2004</year><holder>Christopher Warner</holder></copyright><copyright><year>2008.</year><holder>Timo Jyrinki (timo.jyrinki@iki.fi)</holder></copyright>
15
<!-- translators: uncomment this:
19
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
26
<revnumber>Ekigan ohjekirja 3.0</revnumber>
27
<date>2008-08-31</date>
29
<para role="author">Damien Sandras</para>
33
<revnumber>Ekigan ohjekirja 2.0</revnumber>
34
<date>2006-01-22</date>
39
<publishername>Damien Sandras</publishername>
40
<address><email>dsandras@seconix.com</email></address>
43
<publishername>Christopher Warner</publishername>
44
<address><email>zanee@kernelcode.com</email></address>
47
<publishername>Matthias Redlich</publishername>
48
<address><email>m-redlich@t-online.de</email></address>
52
<author role="maintainer">
53
<firstname>Damien</firstname>
54
<surname>Sandras</surname>
57
<firstname>Christopher</firstname>
58
<surname>Warner</surname>
59
<othername>zanee</othername>
62
<firstname>Matthias</firstname>
63
<surname>Redlich</surname>
67
<releaseinfo>Tämä ohje on Ekigan versiolle 3.00</releaseinfo>
69
<abstract role="description">
70
<para>Ekiga on monia ääni- ja videokoodekkeja tukeva Internetiä käyttävä sovellus äänen, puheluiden ja videokonferenssien välittämiseen.</para>
74
<indexterm zone="index">
75
<primary>Ekiga</primary>
77
<indexterm zone="index">
78
<primary>Ekiga</primary>
80
<indexterm zone="index">
81
<primary>Ekiga</primary>
85
<!-- What is &app; -->
87
<section id="ekiga-introduction">
88
<title>Johdanto</title>
90
<section><title>Ekiga</title>
91
<para><application>Ekiga</application> on vapaa Internetin (IP) yli ääntä, puheluita ja videokonferensseja välittävä sovellus Linuxilla ja muille Unixeille (esim. BSD, OpenSolaris ja MacOSX). Sen on kirjoittanut Damien Sandras ja se on lisensoitu GNU/GPL:n alaisuuteen.</para>
93
<para>Ekiga taitaa nykyaikaiset Voice over IP -yhteyskäytännöt kuten SIP ja H.323. Se tukee näiden yhteyskäytäntöjen kaikkia pääominaisuuksia, kuten <emphasis>soiton pito</emphasis>, <emphasis>soiton siirto</emphasis>, <emphasis>ennakkosiirto</emphasis>, ... Se tukee myös <emphasis>pikaviestejä</emphasis> ja <emphasis>läsnäolotietoja</emphasis>. Myös edistynyt <emphasis>NAT-läpäisy</emphasis> kuuluu mukaan. Ekiga tukee parhaimpia <emphasis>vapaita</emphasis> ääni- ja videokoodekkeja ja äänenlaatua parantavia laajakaista- ja kaiunpoistotekniikoita.</para>
96
<section><title>SIP ja H.323</title>
98
The Session Initiation Protocol (SIP) is a protocol developed by the IETF MMUSIC Working Group and proposed standard for initiating, modifying, and terminating an interactive user session that involves multimedia elements such as video, voice, instant messaging, online games, and virtual reality. In November 2000, SIP was accepted as a 3GPP signaling protocol and permanent element of the IMS architecture. It is one of the leading signalling protocols for Voice over IP.
102
H.323 was originally created to provide a mechanism for transporting multimedia applications over LANs but it has rapidly evolved to address the growing needs of VoIP networks. One strength of H.323 was the relatively early availability of a set of standards, not only defining the basic call model, but in addition the supplementary services, needed to address business communication expectations. H.323 was the first VoIP standard to adopt the IETF standard RTP to transport audio and video over IP networks. H.323 is based on the ISDN Q.931 protocol and is suited for interworking scenarios between IP and ISDN, respectively between IP and QSIG. A call model, similar to the ISDN call model, eases the introduction of IP Telephony into existing networks of ISDN based PBX systems.
105
<graphic fileref="figures/lumi.png"/>
110
<section id="ekiga-getting-started">
111
<title>Aloittaminen</title>
113
When starting <application>Ekiga</application> for the first time the configuration assistant will show automatically. The Configuration Assistant is a step-by-step questionnaire that will guide you through all the steps involved in creating the basic configuration you will need to operate <application>Ekiga</application>.
114
You should go through all of these steps properly, otherwise the assistant will re-appear (when it has not been completed) or <application>Ekiga</application> will not function appropriately (if some of your answers have not been correct).
115
You may run the Configuration Assistant at any time from the Edit menu.
118
<tip><title>Vinkki</title><para>Kaikkia asetuksia voidaan muuttaa milloin vain Asetukset-ikkunassa.</para></tip>
121
<section><title>Johdanto ohjattuun asetusten tekoon</title>
124
<graphic fileref="figures/config_d1.png"/>
128
Throughout the entire configuration process navigation is available at the bottom of the window. You will be able to navigate through the questions using Back, Forward and Cancel.
129
If you hit Cancel during the setup <application>Ekiga</application> will not be affected by your changes and all entered information will be discarded.
133
This page welcomes you to the Configuration Assistant. There is nothing to change or edit here.
134
Press the 'Forward' button towards the bottom of the window to start the configuration.
139
<section><title>Henkilötiedot</title>
142
<graphic fileref="figures/config_d2.png"/>
146
The Personal Information window requires you to supply personal information
147
to use <application>Ekiga</application>.
148
This information is displayed when connecting to other audio/video applications.
153
<section><title>Ekiga.net-tili</title>
156
<graphic fileref="figures/config_d3.png"/>
160
Ekiga.net is a free SIP services platform provided to <application>Ekiga</application> users.
161
If you want to call other users and to be callable, you need a SIP address. You can get one from <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink>.
162
Ekiga.net also offers additional services like conference rooms, voice mail or online white pages. Please see <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink> for more information.
166
Just follow the link given in the dialog to get an account if you do not have one, then fill in your username and password.
167
Please press 'Forward' after having entered all required information to continue.
172
<section><title>Ekigan ulossoittotili</title>
175
<graphic fileref="figures/config_d4.png"/>
178
<para><application>Ekiga</application> can be used with several Internet Telephony Service Providers. Those providers will allow calling real phones from your computer using <application>Ekiga</application> at interesting rates. We are recommending you to use the default <application>Ekiga</application> provider.</para>
180
<para>If you want to create an account and use it to call your friends and family using regular phones at interesting rates, simply create an account using the "Get an Ekiga Call Out account" link. Once the account has been created, you will receive a login and a password by e-mail. Simply enter them in the dialog, and you are ready to call regular phones using <application>Ekiga</application></para>
182
<para>With the default setup, you can simply use sip:3210444555 and choose sip.diamondcard.us to call the real phone number +3210444555, 32 is the country code, 10444555 is the number to call. We encourage you putting your favorite phone numbers in the address book.</para>
185
Just follow the link given in the dialog to get an account if you do not have one, then fill in your username and password.
186
Please press 'Forward' after having entered all required information to continue.
191
<section><title>Yhteystyyppi</title>
194
<graphic fileref="figures/config_d5.png"/>
198
<application>Ekiga</application> supports several audio and video codecs. It includes codecs with excellent quality as well as codecs with medium to good quality. The higher the quality of a codec, the more bandwidth it requires. Moreover, video codecs can adapt their quality to the available bandwidth. This option is necessary in the initial configuration of <application>Ekiga</application> so that it chooses the optimal codec suited to your network connection and so that it adjusts the video quality settings.
199
If your connection type is not mentioned in the list you should select the one closest to your network connection and adjust <application>Ekiga</application> manually with the preferences window (codecs section) later on.
203
When done, continue on with the Configuration.
208
<section><title>Äänilaitteet</title>
211
<graphic fileref="figures/config_d6.png"/>
215
<application>Ekiga</application> requires audio devices to play and record sound. The audio output device ouputs the incoming sound stream during a call. Please select the device that your headset or speakers are connected to. The audio input device is where your microphone is connected to. These settings might be the same as the settings for the audio player if you have only one soundcard. But please note that it is also possible to record sound via another device (e.g. internal microphone in a webcam) too.
216
This section also allows you to choose the ringing device. This device can be different from the audio output device. It allows you hearing the incoming call ringing sound event in your speakers, while having your headset connected for calls.
220
When done, continue on with the Configuration.
225
<section><title>Videolaitteet</title>
228
<graphic fileref="figures/config_d7.png"/>
232
This step is optional and concerns users with video devices (e.g. webcams) only. If you do not have any video devices you may skip this page.
235
<para>If you have a webcam or video device in the list you may select it here.</para>
238
When done, continue on with the Configuration.
243
<section><title>Asennus päättynyt</title>
246
<graphic fileref="figures/config_d8.png"/>
250
The configuration of <application>Ekiga</application> is now completed. The last window only shows a short configuration summary of the settings you have chosen. Please verify that all these settings are correct. If something is incorrect you may use the 'Back' button in the lower right hand corner of the window to move to any page of the assistant and correct the mistake.
254
If everything is correct please press the 'Apply' button to save the configuration. The assistant will be closed and the main Window of <application>Ekiga</application> will now appear. Remember, all settings can be changed via the preferences window at anytime.
263
<section id="ekiga-basic-usage">
264
<title>Peruskäyttö</title>
266
<section id="ekiga-calling-and-being-called">
267
<title>Soittaminen ja soittoihin vastaaminen</title>
269
<graphic fileref="figures/call_d1.png"/>
271
<section><title>Tietokoneelta tietokoneelle (PC-To-PC)</title>
272
<para>If you want to call other users and to be callable, you need a SIP address. You can get a SIP address from <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink> as described above.</para>
274
<para>The SIP address can be used by other users to call you. Similarly, you can use the SIP address of your friends and family to call them. You can for example use <emphasis>sip:dsandras@ekiga.net</emphasis> to call the author of Ekiga.</para>
276
<para>You can use the online address book of <application>Ekiga</application> to find the SIP addresses of other <application>Ekiga</application> users. It is of course possible to call users who are using another provider than ekiga.net. You can actually call any user using SIP software or hardware, and registered to any public SIP provider</para>
278
<para>If you know the URI address of the party that you wish to call, you may enter that URI into the sip: input box at the top of the screen and press the Connect button; eg: sip:foo@ekiga.net and pressing the Connect button would call the user at that address.</para>
280
<para>It is also possible to call contacts using the address book, the call history or the roster. You can add contacts you call frequently to your roster, and watch their presence information in order to know when they are available. Please refer to the appropriate section of the manual for full explanations.</para>
282
<tip><title>Vinkki</title><para><application>Ekiga</application> also supports H.323 and as such can call any H.323 software or hardware. Please refer to the section related to URIs to learn more about the various types of URIs that can be used to call remote H.323 and SIP users.</para></tip>
285
<section><title>Tietokoneelta oikeisiin puhelimiin (PC-To-Phone)</title>
286
<para><application>Ekiga</application> can be used with several Internet Telephony Service Providers. Those providers will allow calling real phones from your computer using <application>Ekiga</application> at interesting rates. We are recommending you to use the default <application>Ekiga</application> provider. You can get an account using the links in the configuration assistant as described above.</para>
288
<para>With the default setup, you can simply use sip:3210444555 and select sip.diamondcard.us in the list to call the real phone number +3210444555, 32 is the country code, 10444555 is the number to call.</para>
290
<para>You can also dial real phone numbers from the address book. If the phone number of the contact you want to call is stored in the address book, simply select Action -> Call [Ekiga Call Out] when the contact is highlighted. It will dial the phone number of the contact using the Ekiga Call Out account.</para>
292
<tip><title>Vinkki</title><para><application>Ekiga</application> also supports connecting to H.323 and SIP PBX systems. If the PBX at your office supports those protocols, you will be able to call real phones and be called from real phones after having connected to the PBX. Please ask for the settings to your administrator.</para></tip>
295
<section><title>Oikeasta puhelimesta tietokoneelle (Phone-To-PC)</title>
296
<para><application>Ekiga</application> can be used to receive incoming calls from regular phones. To allow this, you can simply login to your PC-To-Phone account using the Tools menu as described above, and buy a phone number in the country of your choice. <application>Ekiga</application> will ring when people will call that phone number.</para>
298
<tip><title>Vinkki</title><para>You can actually use any H.323 or SIP ITSP provider, including your own PBX at work. However we recommend using the integrated provider.</para></tip>
304
<section id="ekiga-manage-contacts">
305
<title>Tuttavien hallinta</title>
306
<section><title>Tuttavien lisääminen nimilistaan</title>
308
<graphic fileref="figures/roster.png"/>
311
<application>Ekiga</application> allows you to add the contacts you dial the most in the roster. It allows to call them or start a chat conversation with your friends without having to remember their URI.
312
If supported by the service, <application>Ekiga</application> will display <emphasis>extended presence information</emphasis> about your friends.
313
Ekiga.net supports publishing presence information for its users. Software PBX systems like <ulink url="http://www.asterisk.org" type="http">Asterisk</ulink> can report if an user is on the phone or not, and <application>Ekiga</application> will display that information in its roster.
317
You can thus use <application>Ekiga</application> to monitor lines on your PBX.
321
<application>Ekiga</application> is also able to detect other <application>Ekiga</application> users on the LAN using the Bonjour technology popularized by Apple (tm) and to display them in the roster. That supposes you have a local mDNSResponder daemon running on your computer.
325
To add a contact to the roster, select Chat->Add Contact, and fill in the required fields. If the service managing the URI you entered for the contact is able to publish presence status, Ekiga will automatically display it.
329
If you do not know the VoIP URI of a contact, you might try searching for him using the Ekiga.net online directory. To do so, select Chat -> Address Book, and start searching using the 'Search Filter' feature.
332
<tip><title>Vinkki</title><para>Tuttavia voidaan lajitella ryhmiin nimilistassa.</para></tip>
334
<section><title>Tuttavien hallinta</title>
336
<graphic fileref="figures/addressbook_d1.png"/>
339
<application>Ekiga</application> allows you looking for contacts using various sources like the <ulink url="http://www.novell.com/products/evolution" type="http">Novell Evolution</ulink> address book, an LDAP directory or the Ekiga.net contact directory. You can use the result of your search to start a chat, call the contact, or simply add him to your roster if you have frequent calls with him. To start looking for contacts, select Chat -> Address Book in the menu.
340
To your left there will be a list dialog showing the LDAP directories as well as a list of local Address Books. The defaults are the <application>Ekiga</application> white pages, and the personal address book from <ulink url="http://www.novell.com/products/evolution" type="http">Novell Evolution</ulink>. Support for more contact sources is possible.
344
<application>Ekiga</application> is able to browse any LDAP directory and use a specific attribute as calling URI. For example, you could have an LDAP directory in your company, with a specific attribute containing the local extensions of all your colleagues. <application>Ekiga</application> is able to use such an LDAP directory. Simply select in Address Book -> Add an LDAP Address Book, and fill in the required details. You can then right-click on the contact and call him using the call attribute as VoIP URI.
348
To refresh the list of users for a specific address book, simply click the Find button. It will search for all users in that address book. You can contact people by double clicking on their highlighted field. You can also message them by right-clicking or by choosing the appropriate action in the Action menu of the window.
352
In certain cases you will want to search specifically for a person name, or his or her call URI in the <application>Ekiga</application> white pages. The address book window allows you to apply filters when searching for contacts.
355
<tip><title>Vinkki</title><para>The <application>Ekiga</application> white pages will allow you to look for users in your region. It returns a limited number of results corresponding to your search. You can then add him to your personal roster to call him later.</para></tip>
358
<section><title>Yhteystietojen muokkaaminen</title>
360
<graphic fileref="figures/addressbook_d2.png"/>
363
Local address books provided by Novell Evolution allow you adding new contacts, or editing existing contacts. Each different address book allows a different set of features depending on what makes sense for the address book in question. To discover what features are possible, simply select the address book and consult the Action menu.
367
To add a contact to one of your local address books, simply select the address book you wish to add the contact to and select Action -> New Contact. The option of adding a New Contact will appear and you may now enter his name and VoIP URI as well as other settings. After complete select 'OK' and now your contact has been added. You can only add contacts to local address books. The contact parameters can be changed at any time by selecting Action -> Properties when the contact is highlighted. He can also be deleted by selecting Action -> Remove.
371
You can also add a contact from the white pages (or any other local or remote address book) to the roster by selecting Action -> Add to local roster when the contact is highlighted.
375
Finally, you can edit the groups your users belong to using the Action -> Properties dialog when the contact is highlighted.
381
<section id="ekiga-sending-instant-messages">
382
<title>Pikaviestien lähettäminen</title>
384
<graphic fileref="figures/chat_d1.png"/>
387
<application>Ekiga</application> allows you to send instant messages to remote users provided that you know their URI.
391
You can send instant messages from the roster, from the call history or from the address book. From the roster or from the call history, simply select Contact -> Message in the main window when a contact is highlighted. From the address book window, simply select Action -> Message when the contact is highlighted. A window pops up, enter your text message, and hit the Enter key.
394
<tip><title>Vinkki</title><para>You can not exchange text messages with all protocols. <application>Ekiga</application> will only display the Message menun item when the protocol associated with the user permits it.</para></tip>
398
<section id="ekiga-changing-status">
399
<title>Oman tilan päivittäminen</title>
401
<graphic fileref="figures/status.png"/>
404
<application>Ekiga</application> allows you to publish your status to other users.
408
There are three categories of status messages : online, away and do not disturb. Each of them allows you to specify a more complete status information. Simply select Custom message in the status menu at the bottom of the main window. You can then define your extended status message that will be published using all available protocols supporting it.
411
<tip><title>Vinkki</title><para>Many servers will not accept to relay your extended presence information. To make sure that this feature is available with the server you are using or with the PBX you are connected to, please ask your administrator. Please note that Ekiga.net will publish your presence information.</para></tip>
415
<section id="ekiga-manage-calls">
416
<title>Puheluiden hallinta</title>
418
<section><title>Sisääntulevien puheluiden uudelleenohjaus</title>
420
<application>Ekiga</application> supports different policies for unanswered incoming calls. Per default it displays a
421
popup window which allows you to decide whether you want to refuse or accept the request for
422
an incoming call. If you do not answer the call in the required time, or if you are busy, or if you do not want to receive any call, <application>Ekiga</application> can forward the call to another party.
426
Notice that you need to specify an URI where to forward calls in the preferences to be able to activate that option. Open the preferences window by choosing Edit -> Preferences in the main window and select Call Options on the left. You will now see the appropriate section. It contains three checkboxes for the three cases described above. The URI of the party the calls shall be forwarded to can be configured separate in SIP Settings for SIP and accordingly in H.323 Settings for H.323.
430
<section><title>Puhelun hallinta</title>
431
<para><application>Ekiga</application> supports several actions which can be performed when in a call. These actions enable you to control active sessions.</para>
435
<para>Ending a call: The communication to the remote user can be ended by selecting Chat -> Hang up.</para>
439
<para>Holding a call: You can hold a remote party call by selecting Chat -> Hold Call. This effectively pauses Video and Audio transmission, to continue transmission again you select Chat -> Retrieve Call and Video and Audio Transmission will begin again.</para>
443
<para>Suspend Audio: This effectively prevents all Audio communication to your respective party when selecting Chat -> Suspend Audio.</para>
447
<para>Suspend Video: This effectively prevents all Video transmission to your respective party when selecting Chat -> Suspend Video.</para>
451
<para>Transferring the remote party: You can transfer the remote user to another user by selecting Chat -> Transfer Call. It is also possible to transfer an active call by right-clicking and choosing the transfer action when a contact is highlighted in the roster, in the address book or in the call history. Double-clicking or selecting the Contact menu in the main window or the Action menu in the Address Book window and choosing the transfer action will also work.</para>
455
<tip><title>Vinkki</title><para>All URIs supported by <application>Ekiga</application> can be used for call transfer if the protocol supports it.</para></tip>
458
<section><title>Ääni- ja videoasetusten muuttaminen</title>
460
Your audio and video settings can be adjusted through the call panel while you are in a call. If you want to change the audio or video settings during a call, simply show the Call Panel by select View -> Show Call Panel in the menu. The audio volume, but also the brightness, whiteness, color and contrast of your video input device can be changed to achieve the best quality.
464
You can also change your audio and video devices during a call. Simply go in the preferences window by selecting Edit -> Preferences in the menu, and adjust your devices in the appropriate section.
468
<section><title>Soittohistorian tarkistaminen</title>
470
<graphic fileref="figures/call_history.png"/>
472
<para>The Call History stores information (date, duration, URI, Remote user) about all outgoing and incoming calls. They are divided into three groups - received calls, placed calls and missed calls. You can consult the call history by selecting View -> Call History in the menu.
476
Received calls contains all incoming calls which were accepted by <application>Ekiga</application>
482
Placed calls keeps track of all attempts - succesful or not - to call another user.
488
Missed calls shows incoming calls which timed out.
494
<tip><title>Vinkki</title><para>Double-clicking on a row in the Calls History will call back the selected user or transfer any active call to that user. Notice that you can also add the contact to your roster by selecting Chat -> Contact -> Add to local roster in the main menu when the call is highlighted.</para></tip>
501
<section id="ekiga-advanced-usage">
502
<title>Edistynyt käyttö</title>
504
<section id="ekiga-registering-additional-accounts">
505
<title>Lisätilien rekisteröiminen</title>
507
<section><title>Tilit-ikkuna</title>
509
<graphic fileref="figures/accounts_d1.png"/>
512
You can open the accounts window by selecting Edit -> Accounts. This will open the Accounts Window. The Accounts Window will allow you to add Ekiga.net, Ekiga Call Out, SIP and H.323 accounts and to register to them.
513
An account describes the user login and password parameters to register to SIP and H.323 services. Those <emphasis>services</emphasis> can be an Internet Telephony Service provider (like ekiga.net), or an IPBX (like CISCO, Nortel, or Asterisk).
517
<section><title>Ekiga.net-tilin lisääminen</title>
519
<graphic fileref="figures/accounts_ekiga_net.png"/>
522
To add an Ekiga.net account, simply select Account -> Add an Ekiga.net Account in the menu. A dialog will appear and allow you to enter several parameters:
524
<listitem><para><emphasis>User:</emphasis> You can enter your login.</para></listitem>
525
<listitem><para><emphasis>Password:</emphasis> You can enter your password.</para></listitem>
530
Ekiga.net is a free SIP services platform provided to <application>Ekiga</application> users.
531
If you want to call other users and to be callable, you need a SIP address. You can get one from <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink>.
532
Ekiga.net also offers additional services like conference rooms, voice mail or online white pages. Please see <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink> for more information.
536
<section><title>Adding an Ekiga Call Out account</title>
538
<graphic fileref="figures/accounts_ekiga_call_out.png"/>
541
To add an Ekiga Call Out account, simply select Account -> Add an Ekiga Call Out Account in the menu. A dialog will appear and allow you to enter several parameters:
543
<listitem><para><emphasis>Account ID:</emphasis> You can enter your account ID.</para></listitem>
544
<listitem><para><emphasis>PIN Code:</emphasis> You can enter your PIN code.</para></listitem>
549
If you do not have an Ekiga Call Out account yet, you can subscribe for one using the 'Get an Ekiga.net Call Out account' link in the dialog.
550
As described above, this service will allow you calling normal phones worldwide at interesting rates.
551
Once the account has been added, you can recharge it, consult the balance history or the call history by selecting the appropriate menu item in the Account menu of the window when the account is highlighted.
555
<section><title>SIP-tilin lisääminen</title>
557
<graphic fileref="figures/accounts_sip.png"/>
560
To add a SIP account, simply select Account -> Add a SIP Account in the menu. A dialog will appear and allow you to enter several parameters:
562
<listitem><para><emphasis>Name:</emphasis> You can enter the account name.</para></listitem>
563
<listitem><para><emphasis>Registrar:</emphasis> The registrar to which you want to register. This is usually an IP address or an host name that will be given to you by your Internet Telephony Service Provider, or by your administrator if you are trying to register to a SIP IPBX.</para></listitem>
564
<listitem><para><emphasis>User:</emphasis> You can enter your login.</para></listitem>
565
<listitem><para><emphasis>Authentication User:</emphasis> If it is different from the user parameter you provided above. In that case, the user field will be used to control the outgoing identity for the account you are adding, while the login will be used during the authentication phase.</para></listitem>
566
<listitem><para><emphasis>Password:</emphasis> You can enter your password.</para></listitem>
567
<listitem><para><emphasis>Timeout:</emphasis> The timeout after which the registration should be refreshed.</para></listitem>
573
<section><title>H.323-tilin lisääminen</title>
575
<graphic fileref="figures/accounts_h323.png"/>
578
To add an H.323 account, simply select Account -> Add an H.323 Account in the menu. A dialog will appear and allow you to enter several parameters:
580
<listitem><para><emphasis>Name:</emphasis> You can enter the account name.</para></listitem>
581
<listitem><para><emphasis>Gatekeeper:</emphasis> The gatekeeper to which you want to register. This is usually an IP address or an host name that will be given to you by your Internet Telephony Service Provider, or by your administrator if you are trying to register to an H.323 IPBX.</para></listitem>
582
<listitem><para><emphasis>User:</emphasis> You can enter your login.</para></listitem>
583
<listitem><para><emphasis>Authentication User:</emphasis> If it is different from the user parameter you provided above. In that case, the user field will be used to control the outgoing identity for the account you are adding, while the login will be used during the authentication phase.</para></listitem>
584
<listitem><para><emphasis>Password:</emphasis> You can enter your password.</para></listitem>
585
<listitem><para><emphasis>Registration Timeout:</emphasis> The timeout after which the registration should be updated.</para></listitem>
593
<section id="ekiga-uris">
594
<title>URIen ymmärtäminen</title>
596
<section><title>SIP-URIt</title>
598
<para>SIP URIs are formatted as such "sip:user@[host[:port]]"</para>
600
<para>This permits you to call the given user or extension on the specified SIP proxy: <emphasis>sip:jonita@ekiga.net</emphasis></para>
604
<section><title>H.323-URIt</title>
606
<para>H.323 URIs are formatted as such "h323:[user@][host[:port]]"</para>
608
<para>This permits you to:
610
<listitem><para>Call a given host on a port different from the default port which is 1720: <emphasis>h323:seconix.com:1740</emphasis></para></listitem>
611
<listitem><para>Call a given user using their respective alias if registered to a gatekeeper: <emphasis>h323:jonita</emphasis></para></listitem>
612
<listitem><para>Call a given phone number if you are registered to a gatekeeper for a PC-To-Phone provider, or if that user has an ENUM record associated to an H.323 URI: <emphasis>h323:003210111222</emphasis></para></listitem>
613
<listitem><para>Call a given user using their alias through a specific gateway or proxy: <emphasis>h323:jonita@gateway.seconix.com</emphasis></para></listitem>
614
<listitem><para>Call an MCU and join a specific room: <emphasis>h323:myfriendsroom@mcu.seconix.com</emphasis></para></listitem>
622
<section id="ekiga-video-bandwidth">
623
<title>Controlling the Video Bandwidth</title>
625
<para><application>Ekiga</application> is using a best-effort algorithm to maintain a low bandwidth when transmitting video. You can adjust the video quality settings following you prefer to have a good frame rate, or a good picture quality. It will permit <application>Ekiga</application> to dynamically adjust the video bandwidth and the number of transmitted images per second during a call while trying to respect the requested video bandwidth.</para>
627
<para>Notice that the algorithm is a best-effort algorithm, which means that if you specify too low video bandwidth settings, it can be impossible to respect them. However, if the video bandwidth permits to transmit with a better quality, or faster than the requested values, then <application>Ekiga</application> will dynamically increase them so that the quality and the framerate are always the best possible.</para>
629
<para>Choosing a higher framerate and a lower quality will have the same result in terms of video bandwidth than choosing a higher quality with a lower framerate. It depends if you prefer using your bandwidth to transmit more lower quality images or fewer big quality images.</para>
633
<section id="ekiga-monitoring-lines">
634
<title>Monitoring lines</title>
636
<graphic fileref="figures/monitoring_lines.png"/>
638
<para><application>Ekiga</application> can connect to PBX systems supporting the SIP protocol. In that case, it is able to indicate if the line associated with an user is in use or not. Please refer to the documentation of your PBX to enable that feature.</para>
640
<para>To enable that feature on <application>Ekiga</application>, simply add the contact with his URI in the roster. If the server supports publishing presence information, <application>Ekiga</application> will automatically publish your own presence information and display the presence of contacts in your roster.</para>
643
<section id="ekiga-audio-codecs">
644
<title>Koodekkien hallinta</title>
646
<section><title>Äänikoodekit</title>
648
<graphic fileref="figures/audio_codecs.png"/>
651
The <application>Ekiga</application> audio codecs table in the preferences permits you to change the codecs order as well as disabling the codecs you don't want to use. Each codec has strong and weak points. For example, G.711 will give the best voice quality but will use the most bandwidth while SPEEX will give an average voice quality but requiring a very low bandwidth usage. Notice that there are two versions of SPEEX, one of them is SPEEX WideBand. You can see that to the 16 kHz clock rate.</para>
654
<section><title>Videokoodekit</title>
656
<graphic fileref="figures/video_codecs.png"/>
659
The <application>Ekiga</application> video codecs table in the preferences permits you to change the codecs order as well as disabling the codecs you don't want to use. <application>Ekiga</application> supports codecs like H.261, H.263+, H.264, MPEG-4 or Theora.</para>
663
<section><title>Koodekkien järjestyksen muuttaminen</title>
665
When you reorder the codecs, you are reordering the local capabilities table, ie the codecs you will use for sending. You will always transmit audio and video using the first codec in the corresponding table that is in common with the remote user. The remote user will transmit audio and video using the first codec in his table that is common with you.</para>
668
<section><title>Forcing the use of a specific codec</title>
670
You can force the use of a specific codec by disabling all other codecs, but it will result in failed calls if the remote user doesn't allow that specific codec. The best is to put your prefered codecs at the top of the list so that you always transmit with them if the remote user allows it and to disable the codecs that you don't want to use for transmission and reception.</para>
673
<section><title>Adjusting the jitter buffer</title>
675
You can adjust the delay to wait before playing the sound buffers that you have received using the jitter buffer adjustment. If there is too much packets loss, the delay required to have received all packets could be so important that it will exceed the jitter buffer. In such a case, the sound you are receiving will be of bad quality. A solution to that problem would be to increase the maximum limit of the jitter buffer to a few seconds, resulting in a big delay but in an improved voice quality. Notice that the jitter buffer will readapt itself to the lowest delay allowing for optimum transmission, and that a bad voice quality in reception is not due to a too low jitter buffer value, but to bad internet connection quality.
682
<section id="ekiga-defining-ports">
683
<title>Porttien muuttaminen</title>
685
<section><title>Vastaanottoportit</title>
687
The main port listening for incoming connections in <application>Ekiga</application> for SIP is port 5060 (UDP), while 1720 (TCP) is used by H.323. To change those ports you need to load "gconf-editor". Open gconf-editor, select apps from the left hand side menu and then select <application>Ekiga</application>. Then select "sip" or "h323", it should give you a list in the corresponding window to your right. Select listen_port and change it to your desired value. You can also change the UDP/RTP port ranges.
691
<section><title>Selvennys porttiväleistä</title>
693
<para>1. The "listen_port" value is the port <application>Ekiga</application> will listen for incoming connections on. It is different for SIP and H.323.</para>
695
<para>2. The "udp_port_range" value is the range of UDP ports that <application>Ekiga</application> will use for SIP signalling or when registering to H.323 gatekeepers. It is also used for RTP (audio and video communication channels).</para>
697
<para>3. The "tcp_port_range" value is the range of TCP ports beside the listen_port that <application>Ekiga</application> will use for the H.245 channel with the H.323 protocol. That port range is not used by SIP. It is not used either when H.245 Tunneling is enabled, which is in general always the case, except when calling old H.323 implementations like Netmeeting.</para>
702
<section id="controlling-sip-h323-settings">
703
<title>SIP- ja H.323-asetusten hallinta</title>
704
<section id="ekiga-sip">
705
<title>SIP-asetusten hallinta</title>
707
<section><title>Sekalaiset asetukset</title>
708
<para><emphasis>Lähtevien välipalvelin</emphasis></para>
709
<para>The outbound proxy is the SIP proxy that will relay your calls. The behavior of a SIP proxy is similar to the behavior of an HTTP proxy, ie some entity that issues the requests on your behalve and proxies the streams.</para>
711
<para><emphasis>Uudelleenohjaus-URI</emphasis></para>
712
<para>The URI to which SIP incoming calls should be forwarded if configured in the preferences.</para>
717
<section id="ekiga-h323">
718
<title>H.323-asetusten muuttaminen</title>
720
<section><title>Sekalaiset asetukset</title>
721
<para><emphasis>Uudelleenohjaus-URI</emphasis></para>
722
<para>The URI to which H.323 incoming calls should be forwarded if configured in the preferences.</para>
726
<section><title>Lisäasetukset</title>
727
<para><application>Ekiga</application> permits a fine control of the H.323 settings in the Advanced H.323 Settings section of the preferences. You can enable H.245 Tunneling, Early H.245 and Fast Start.</para>
729
<para><emphasis>H.245-tunnelointi</emphasis></para>
731
<para>H.245 Tunneling is the encapsulation of H.245 messages within H.225/Q.931 messages (H.245 Tunneling). If you have a firewall and enable H.245 Tunneling, there is one less TCP port that you need to allow for incoming connections.</para>
733
<para><emphasis>Aikainen H.245</emphasis></para>
735
<para>This enables H.245 early in the setup and permits to achieve faster call initiation.</para>
737
<para><emphasis>Nopea käynnistys</emphasis></para>
739
<para>Fast Connect is a new method of call setup that bypasses some usual steps in order to make it faster. In addition to the speed improvement, Fast Connect allows the media channels to be operational before the CONNECT message is sent, which is a requirement for certain billing procedures. It was introduced in H.323 version 2.</para>
746
<section id="ekiga-about">
747
<title>Tietoja <application>Ekigasta</application></title>
748
<para><application>Ekigan</application> on kirjoittanut Damien Sandras (<email>dsandras@seconix.com</email>). Lisätietoja <application>Ekigasta</application> löydät <ulink url="http://www.ekiga.org" type="http"><application>Ekigan</application> kotisivuilta</ulink>.</para>
751
To report a bug or make a suggestion regarding this application or this manual, follow the directions in <ulink url="ghelp:user-guide?feedback" type="help">this document</ulink>.
754
<para>This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file COPYING included with the source code of this program. </para>
759
<section id="ekiga-appendix">
762
<section id="ekiga-related">
763
<title>Muita aiheeseen liittyviä ohjelmistoja</title>
765
<para><emphasis>IPBX</emphasis></para>
767
<listitem><para>Asterisk PBX: <ulink url="http://asterisk.org" type="http">http://asterisk.org</ulink></para></listitem>
770
<para><emphasis>SIP</emphasis></para>
772
<listitem><para>SIP Express Router: <ulink url="http://www.iptel.org/ser" type="http">http://www.iptel.org/ser</ulink></para></listitem>
775
<para><emphasis>H.323</emphasis></para>
777
<listitem><para>OpenH323 Gatekeeper (yhdyskäytävä): <ulink url="http://www.openh323.org" type="http">http://www.openh323.org</ulink></para></listitem>
778
<listitem><para>GNU Gatekeeper (yhdyskäytävä): <ulink url="http://www.gnugk.org" type="http">http://www.gnugk.org</ulink></para></listitem>
779
<listitem><para>OpenH323-välipalvelin: <ulink url="http://openh323.sourceforge.net" type="http">http://openh323.sourceforge.net</ulink></para></listitem>
780
<listitem><para>H323 - ISDN -yhdyskäytävä: <ulink url="http://www.telos.de/linux/H323/" type="http">http://www.telos.de/linux/H323/</ulink></para></listitem>
783
<para><emphasis>VoIP/konferenssi-ohjelmistoja</emphasis></para>
786
<listitem><para>OpenMCU: <ulink url="http://www.openh323.org" type="http">http://www.openh323.org</ulink></para></listitem>
789
<para><emphasis>Samankaltaisia asiakasohjelmia</emphasis></para>
792
<listitem><para>XTen: <ulink url="http://www.xten.com" type="http">http://www.xten.com</ulink></para></listitem>
793
<listitem><para>SJPhone: <ulink url="http://www.sjlabs.com/" type="http">http://www.sjlabs.com/</ulink></para></listitem>
794
<listitem><para>OpenPhone: <ulink url="http://www.openh323.org" type="http">http://www.openh323.org</ulink></para></listitem>
795
<listitem><para>Netmeeting: <ulink url="http://www.microsoft.com" type="http">http://www.microsoft.com</ulink></para></listitem>