个人工具

“UbuntuHelp:Ekiga”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
第3行: 第3行:
 
Parent: [[UbuntuHelp:InternetAndNetworking| Internet and Networking]]
 
Parent: [[UbuntuHelp:InternetAndNetworking| Internet and Networking]]
  
Ekiga is the default Internet telephony application, using SIP and H.323, in Ubuntu. It allows you to make audio and video calls over the Internet to remote users who have hardware or software that is compliant with SIP or H.323. Ekiga is compatible with Windows Messenger and most VoIP applications. However, it is not compatible with Skype or Google Talk. If you have the right SIP provider you can also use Ekiga to make calls to any normal phone line. Ekiga can also work through firewalls with STUN.
+
Ekiga is the default Internet telephony (VoIP) application in Ubuntu. It lets you make audio and video calls over the Internet to people who have hardware or software that follows the [http://en.wikipedia.org/wiki/Session_Initiation_Protocol SIP] or [http://en.wikipedia.org/wiki/H.323 H.323] standards. Ekiga also features basic instant messaging.
 +
 
 +
Ekiga has a rubust and wide support for multimedia, and is compatible with Windows Messenger and most VoIP applications. Ekiga cannot communicate with Skype because it uses proprietary technology. If you have the right SIP provider, you can also use Ekiga to place calls to any normal phone line.  
  
'''The general documentation is there:  [http://wiki.ekiga.org/ Ekiga wiki]'''
 
  
  
 
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=ekiga.png
 
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=ekiga.png
 +
 +
=== Desktop interoperability ===
 +
Ekiga works with Linux or [http://www.ekiga.org/admin/downloads/latest/windows/windows/ekiga-setup-2.0.11-BETA.exe Windows]. For Mac OS, you can use the free software [http://xmeeting.sourceforge.net/pages/index.php xmeeting].
 +
 +
Ekiga is compatible with Netmeeting (H.323, windows), Windows Messenger (SIP, Windows, [http://wiki.ekiga.org/index.php/Connecting_Windows_Messenger_5.1_to_ekiga.net how to configure Windows Messenger for ekiga.net]), [[UbuntuHelp:Gizmo|Gizmo]] (SIP, multi-platform), and [http://wiki.ekiga.org/index.php/Which_programs_work_with_Ekiga_%3F other programs listed on the Ekiga documentation].
 +
 +
[http://code.google.com/apis/talk/open_communications.html#service_4 Googletalk is working to implement the industry standard SIP] which will make it possible to communicate with Ekiga users in the future.
  
 
=== First use ===
 
=== First use ===
  
When you start Ekiga for the first time, a 10 step wizard will help you to correctly configure Ekiga. It is '''strongly''' recommended to complete the wizard.
+
When you start Ekiga for the first time, the 10 step '''Configuration druid''' will help you to correctly configure Ekiga. It is '''strongly''' recommended that you complete the druid.
  
When you're done and if you got an account on http://ekiga.net, you can call the echo test : <code><nowiki>sip:500@ekiga.net</nowiki></code>. You'll be able to check if you can reach the service (the SIP network), if your sound setup is ok (you can hear yourself '''with a delay'''), if your webcam works (you can see yourself).
+
[http://wiki.ekiga.org/index.php/Configuring_Ekiga More help about the druid] (step-by-step)
  
==== How to set up an Ekiga.net account ====
+
==== How do I get a free sip:address ? (step 3/10) ====
  
Once you're registered in http://ekiga.net, go to menu <code><nowiki>Edit → Accounts → Add</nowiki></code>
+
At step 3 of 10 in the druid, you'll be asked for your Username and Password. You get them by registring in [http://ekiga.net ekiga.net]. This will gives you a free sip:address. Choose a good Username, this is what you will be giving out to your contacts. A sip:address is a way to be reachable and to reach people. You can compare it to an e-mail address.
  
*Account name: "ekiga.net” or whatever you wish
+
[http://wiki.ekiga.org/index.php/Troubleshooting#Unable_to_register_to_ekiga.net_.3F Please avoid specials characters for your password.] Letters and numbers will do just fine.
*Registrar: <code><nowiki>ekiga.net</nowiki></code>
+
*User: Your nick choosen on ekiga.net
+
*Password: Your password choosen on ekiga.net
+
  
=== Configuration ===
+
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=Capture-FirstTimeConfigurationAssistant3.png
  
==== Network ====
+
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.
  
Ekiga is able to use a STUN server. In most cases everything should be fine even behind a NAT.
+
Your address will be '''<code><nowiki>sip:Username@ekiga.net</nowiki></code>'''
  
==== Sound ====
+
Please press ’Forward’ after having entered all required information to continue.
  
===== Test your computer =====
+
==== How do I place a call ? ====
  
To check if your computer meets the requirements for Ekiga, try this command in a terminal:
+
When you're done the druid and if you have an account on [http://ekiga.net ekiga.net], you can call the echo test: <code><nowiki>sip:[email protected]</nowiki></code> You'll be able to check if you can reach the service (the SIP network), if your sound setup is ok (you can hear yourself '''with a delay''') and if your webcam works (you can see yourself).
  
<pre><nowiki>
+
If you know the SIP address of the party that you wish to call, you may enter that adress into the '''sip: input box''' at the top of the screen and press the Connect button; eg: <code><nowiki>sip:[email protected]</nowiki></code> and pressing the Connect button would call the user at that address.
$ arecord -D plughw:0,0 -c 1 -r 8000 -f S16_LE - | aplay -D plughw:0,0 -c 1 -r 8000 -f S16_LE -
+
</nowiki></pre>
+
  
 +
==== Can I use several sip:addresses ? ====
 +
Yes. First you have to register to the provider (e.g. ekiga.net). Then to add your new sip:address, go to menu '''Edit -> Accounts -> Add'''
  
Now, try to call in your microphone, you should be able to hear yourself in your headset '''with a small delay''' (aproximatly half a second). If it doesn't work as expected, first try to configure ALSA:
+
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=Capture-EdittheAccountInformation.png
  
<pre><nowiki>
+
{|border="1" cellspacing="0"
$ alsamixer
+
|Account name:||enter the name for the '''Edit -> Accounts''' window
</nowiki></pre>
+
|-
 +
|Registrar:||ekiga.net (or another provider)
 +
|-
 +
|User:||Your Username
 +
|-
 +
|Password:||Your password
 +
|}
  
Make sure your microphone is not muted and the volume levels are ok.
+
=== Ekiga.net services (free calls PC-to-PC) ===
  
===== Ekiga and other audio applications =====
+
Ekiga.net is a free service (no ads) based upon Free Software ([http://www.iptel.org/ser/ SER] and [http://www.asterisk.org/ Asterisk]) ran by the Ekiga team.
  
Ekiga is capable of running simultaneously with other sound applications (like music and video players). The following directions should be enough to accomplish this if you are using Dapper Drake:
+
==== Test service ====
  
Go to the menu <code><nowiki>Edit → Preferences → Devices → Audio Devices</nowiki></code>
+
Once you're registered to http://ekiga.net, you can test your setup and line quality by dialing the echo service: <code><nowiki>sip:[email protected]</nowiki></code>
  
*Select "<code><nowiki>ALSA</nowiki></code>" as the audio plugin
+
This service only works with [http://en.wikipedia.org/wiki/G.711 PCMU] or [http://en.wikipedia.org/wiki/Ilbc iLBC] audio codecs, and the [http://en.wikipedia.org/wiki/H.261 H.261] video codec.
*Select "<code><nowiki>Default</nowiki></code>" as output
+
*Select "<code><nowiki>Default</nowiki></code>" as input
+
  
Then go to the menu <code><nowiki>Edit → Preferences → General → Sound Events</nowiki></code>
+
==== Audio conference server ====
  
*Select "<code><nowiki>Default</nowiki></code>" as alternate device output
+
If you are using ekiga.net as your VoIP provider, you can access a conference server via the aliases
  
For additional help using Ekiga simultaneously with other audio applications, see [http://wiki.ekiga.org/index.php/Getting_several_applications_using_the_sound_card_at_the_same_time_%3F Ekiga's wiki].
+
*<code><nowiki>sip:[email protected]</nowiki></code> to join the public conference room
 +
*<code><nowiki>sip:501XXXX@ekiga.net</nowiki></code> where XXXX is the number of your choice representing the number of the room.  
  
==== Webcam ====
+
[For example, a group of friends could meet in conference room 1122 by dialing <code><nowiki>sip:[email protected]</nowiki></code>]
  
Note : Ekiga does not require a webcam.
+
Using 501xxxx, you'll be asked for a "PIN number": dialing a number you can protect the access to your conference room or just dialing # will make this conference public.
  
===== Choosing the right kernel API =====
+
==== How to place a call to other SIP providers (peering) ====
  
The Linux kernel has two ways to communicate with video devices, the old v4l and the new v4l2. It's best to use v4l2, but some drivers only support v4l.
+
Peering is the term given to agreement between VoIP Service Providers which enables the users of one service to call users of another.
  
Go to the menu <code><nowiki>Edit → Preferences → Devices → Video device</nowiki></code>
+
This is usually implemented by dialing a special prefix number and then the number of the receipitant (on the 'other' service).
  
*Try "<code><nowiki>v4l2</nowiki></code>” or "<code><nowiki>v4l</nowiki></code>” as video plugin
+
With Ekiga.net, you can use [http://www.sipbroker.com/sipbroker/action/providerWhitePages SipBroker prefixes].
  
===== Choosing the right video device =====
+
Here are some exemples of prefixes:
  
If you have several video devices (like a TV card and a webcam) you will need to tell Ekiga which one to use:
+
{|border="1" cellspacing="0"
 +
|Prefix||Registrar||Description
 +
|-
 +
|*282||sip.broadvoice.com||Broadvoice, do not work actually (2007 july)
 +
|-
 +
|*747||proxy01.sipphone.com||Gizmo/SIPPhone
 +
|-
 +
|*393||fwd.pulver.com||Freeworlddialup
 +
|-
 +
|*534||sip1.voipbuster.com||Voipbuster
 +
|-
 +
|*551||sip.internetcalls.com||internetcalls
 +
|-
 +
|*248||voip.wengo.fr||Wengo
 +
|}
  
Go to the menu <code><nowiki>Edit → Preferences → Devices → Video device</nowiki></code>
+
You can also use the special prefix *013 to place a call using [http://en.wikipedia.org/wiki/Telephone_Number_Mapping Enum]. As prefixes do not have a standard, Enum tries to solve this situation.
  
Change the channel number until you find the right one.
+
Some numbers you can dial using Ekiga.net:
  
===== Test your webcam =====
+
{|border="1" cellspacing="0"
 +
|Number||Description
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||US toll free numbers (1-800) [http://www.ideasip.com/numbers.php ideasip.com], [http://inter800.com/ search US Toll Free numbers.]
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||[http://www.1-800-555-tell.com/ Tell me] ixcall.net (Speech recognition)
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Wengo echo test (France)
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Freeworlddialup echo test
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Prato City Hall echo test (Italy)
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Freeconferencecall.com
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Gizmo Echo test
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Party Line Sipphone.com
 +
|-
 +
|<code><nowiki>*[email protected]</nowiki></code>||Voxalot.com (US) Echo test
 +
|}
  
To test your webcam you can do this:
+
* [http://wiki.ekiga.org/index.php/Fun_Numbers More fun numbers in the Ekiga online documentation]
  
There are 6 icons on the left side of the main Ekiga window. Push the 4th button from the top (a grey round webcam). If eveything is ok, you'll see the output of the webcam. If not, you'll see the Ekiga logo bouncing slowly.
+
==== How to search a contact in Ekiga White pages ====
  
=== Ekiga.net special numbers ===
+
People registered to Ekiga.net may be reached using the White Pages.
  
==== Echo service ====
+
* Open the Address Book ('''Tools''' → '''Address Book'''), or click the address book button.
 +
* Select "Ekiga White pages".
  
Once you're registered to http://ekiga.net, you can test your setup and line quality by dialing the echo service: <code><nowiki>sip:500@ekiga.net</nowiki></code>.
+
You can search the White pages by name, SIP address, or location. Up to 100 results are returned for any search.
  
==== Audio conference server ====
+
==== Ekiga.net button for your web page ====
  
If you are using 'ekiga.net' as your VoIP provider, you can access a conference server via the aliases
+
You can easily put a button on your web page showing your status: online or offline. If you're online, the visitor can place a call using the button.
  
*<code><nowiki>sip:[email protected]</nowiki></code> to join the public conference room
+
Here is what will appear on your web page:
*<code><nowiki>sip:[email protected]</nowiki></code> where XXXX is the number of your choice representing the number of the room.
+
  
[For example, a group of friends could meet in conference room 1122 by dialing <code><nowiki>sip:5011122@ekiga.net</nowiki></code>]
+
{|border="1" cellspacing="0"
 +
|https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=button-call-me.png%7C%7Cattachment%3Abutton-offline.png%7C%
 +
|}
 +
 
 +
In order to use it, simply add this to your web page:
 +
 
 +
<code><nowiki><script src=”http://www.ekiga.net/status/presence.php?user=YOUR_ID_ON_EKIGA.NET”></script></nowiki></code>
 +
 
 +
where YOUR_ID_ON_EKIGA.NET is simply your username.
 +
 
 +
=== Register to a commercial VoIP provider (landline and mobile phones) ===
 +
 
 +
You can register to a commercial VoIP provider to place calls to normal phone line or cell phone. Ekiga allows you to register several VoIP providers.
 +
 
 +
==== Default provider ====
 +
 
 +
There is no obligation for you to use the default provider.
 +
 
 +
The default provider is [https://www.diamondcard.us/ Diamondcard Worldwide Communication Service], which offers these [https://www.diamondcard.us/exec/voip-rep-acc-type?priInc=/ekiga?sr%3D/secondary/e/ekiga%26pr%3D/templates%26ht%3D/templates&secInc=/ekiga?sr%3D/secondary/e/ekiga%26pr%3D/templates%26ht%3D/secondary/e/ekiga&secAbs=/home/diamond/secondary/e/ekiga&secRel=/secondary/e/ekiga&priAbs=/home/diamond/templates&priRel=/templates&secId=ekiga&lc= rates]
 +
 
 +
*** To purchase the account, go in '''Tools -> PC-To-Phone Account'''. You absolutely need to purchase the account from the PC-To-Phone configuration window or it won't work.
 +
*** Wait for the mail that will give you a login and a PIN.
 +
*** Enter that login and PIN in the appropriate fields in the window and enable the PC-To-Phone service.
 +
 
 +
You are now ready to do PC-To-Phone calls at very low rates all over the world.
 +
 
 +
To dial a number, simply add "00" followed by the country code, and by the phone number you want to reach.
  
These rooms are thus semi-public/semi-private since anyone can join a conference room at any time if they choose the right number.
+
For example, sip:003210111111 to call number 10111111 in Belgium.  
  
=== Broadvoice Support ===
+
==== Broadvoice Support ====
In order to setup Ekiga 2.03 to work with broadvoice, use the following settings.
+
In order to setup Ekiga to work with [http://www.broadvoice.com/ Broadvoice] which offer those [http://www.broadvoice.com/rateplans.html rates], use the following settings.
  
 
Figure out which proxy is closest to you:
 
Figure out which proxy is closest to you:
第130行: 第200行:
 
Ekiga Preferences:
 
Ekiga Preferences:
  
*SIP Settings -> Outbound SIP Proxy: proxy.broadvoice.com
+
* '''SIP Settings''' → '''Outbound SIP Proxy:''' proxy.broadvoice.com
  
*Codecs -> Video Codecs - Disable (uncheck) video support or else you will get a codec error.
+
* '''Codecs''' → '''Video Codecs''' → Disable (uncheck) video support or else you will get a codec error.
  
 
Account Information:
 
Account Information:
第144行: 第214行:
 
*Authentication Login: <10 digit broadvoice telephone number>
 
*Authentication Login: <10 digit broadvoice telephone number>
  
*Realm/Domain: sip.broadvoice.com or BroadWorks
+
*Realm/Domain: sip.broadvoice.com or Broadworks
  
 
In the case where you need to troubleshoot, start ekiga with 'ekiga -d 4'
 
In the case where you need to troubleshoot, start ekiga with 'ekiga -d 4'
  
=== Interoperability ===
+
==== How to set up a Gizmo account ====
 +
[http://gizmoproject.com/ Gizmo] offers those [http://gizmoproject.com/call-out-rates.php rates].
  
You'll find [http://wiki.ekiga.org/index.php/Which_programs_work_with_Ekiga_%3F here] a list of programs which can work with Ekiga.
+
To subscibe an account, go [https://signup.sipphone.com/new-users/app?class=NewUser;proc=start here] and open a Sipphone account. Then, with your account number and your password go [https://my.gizmoproject.com/gizmo/app?class=MySip&proc=start there], you'll be prompted to choose a Gizmo name.
  
=== Development Snapshots ===
+
Now go to menu <code><nowiki>Edit → Accounts → Add</nowiki></code>
  
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=ekiga1.png
+
{|border="1" cellspacing="0"
 +
|Account name:||whatever you wish
 +
|-
 +
|Registrar:||<code><nowiki>proxy01.sipphone.com</nowiki></code>
 +
|-
 +
|User:||Your Gizmo number (1747xxxxxxx)
 +
|-
 +
|Password:||Your password
 +
|}
  
You can get the latest development snapshots from here:
+
Then try the echo test: <code><nowiki>sip:[email protected]</nowiki></code>
[http://snapshots.voxgratia.org/]
+
 
Installing them may solve problems you are experiencing but be aware that the snapshots could also cause more problems. A good thing to do before installing snapshots is to uninstall all pwlib, opal and ekiga packages that may already be installed.
+
==== How to set up a Wengo account ====
 +
 
 +
[http://www.wengophone.com Wengo] offer this [http://www.wengophone.com/index.php/aboutcallout rates].
 +
 
 +
Once you've registered at https://secure.wengo.com/register/wengophone/index.php?yawl[S]=wengo.public.homePage&yawl[K]=wengo.subs_152.persistOffer&lang=eng
 +
, visit
 +
 
 +
<code><nowiki>https://ws.wengo.fr/softphone-sso/sso.php?login=YOUR-EMAIL&password=YOUR-PASSWORD</nowiki></code>
 +
 
 +
where <code><nowiki>YOUR-EMAIL</nowiki></code> and <code><nowiki>YOUR-PASSWORD</nowiki></code> are what you used when you registered your account. [http://dev.openwengo.org/trac/openwengo/trac.cgi/wiki/GetYourWengoPlatformSipPassword This will give you your real username and password]:
 +
<pre><nowiki>...
 +
<userid>Username</userid>
 +
...
 +
<password>Password</password>
 +
...</nowiki></pre>
 +
 
 +
Now go to menu <code><nowiki>Edit → Accounts → Add</nowiki></code>
 +
 
 +
{|border="1" cellspacing="0"
 +
|Account name:||whatever you wish
 +
|-
 +
|Registrar:||<code><nowiki>voip.wengo.fr</nowiki></code>
 +
|-
 +
|User:||the username from the ws.wengo.fr url above
 +
|-
 +
|Password:||the password from the ws.wengo.fr url above
 +
|}
 +
 
 +
Now try the echo test: <code><nowiki>sip:[email protected]</nowiki></code>
 +
 
 +
 
 +
=== Configuration ===
 +
 
 +
This section covers the configuration of Ekiga.
 +
 
 +
==== Network ====
 +
Ekiga is able to use a [http://en.wikipedia.org/wiki/STUN STUN server]. In most cases the defaults should work fine, even for users of consumer-grade firewalls.
 +
 
 +
However, for advanced users or complex setups, here is the list of ports used by Ekiga:
 +
 
 +
{|border="1" cellspacing="0"
 +
|Protocol||Port||Type of port||Description
 +
|-
 +
|SIP||5000 to 5100||UDP||SIP signalling, listen port: 5060
 +
|-
 +
|STUN||3478 to 3479||UDP||Outgoing traffic to [http://en.wikipedia.org/wiki/STUN STUN servers]
 +
|-
 +
|H323||1720||TCP||Listen port
 +
|-
 +
|H323||5000 to 5100||UDP||gatekeepers H.323
 +
|-
 +
|H323||30000 to 30010||TCP||H.245 channel for old implementations H.323 (Netmeeting)
 +
|}
 +
 
 +
===== Several Ekigas on a LAN =====
 +
 
 +
There are several programs which allow copies of Ekiga to communicate with each other; you can use a SIP proxy (like [http://siproxd.sourceforge.net/ Siproxd]) or a PBX (like [http://www.asterisk.org/ Asterisk]. Further information about Ekiga and Asterisk can be found on the [http://wiki.ekiga.org/index.php/Main_Page Ekiga documentation]), or you can use [[UbuntuHelp:HowToZeroconf|Avahi]].
 +
 
 +
====== Avahi ======
 +
 
 +
Avahi is the main implementation of [http://en.wikipedia.org/wiki/Zeroconf ZeroConf protocol] under Ubuntu (known as Rendezvous or Bonjour on Mac OS X). This technology allows automatic discovery of services.
 +
 
 +
To set up Avahi, please follow the [[UbuntuHelp:HowToZeroconf|Zeroconf Howto]].
 +
 
 +
Other copies of Ekiga on the LAN should appear in the Address Book (third button on the left) if you double-click on ''Contacts Near Me''.
 +
 
 +
==== Sound ====
 +
 
 +
This section is about testing and changing the sound configuration in Ekiga.
 +
 
 +
===== Test your computer =====
 +
 
 +
The audio test in the configuration druid will show you if there is any audio problem.
 +
 
 +
In case of audio problem, to check if your computer meets the requirements for Ekiga, try this [https://help.ubuntu.com/community/CommandlineHowto command in a terminal]:
 +
 
 +
<pre><nowiki>
 +
$ arecord -D plughw:0,0 -c 1 -r 8000 -f S16_LE - | aplay -D plughw:0,0 -c 1 -r 8000 -f S16_LE -
 +
</nowiki></pre>
 +
 
 +
Now, speak into your microphone. You should be able to hear yourself in your headset with a small delay (approximately half a second). If it doesn't work as expected, first try to setup correctly your audio desktop configuration: make sure your microphone is not muted and the volume levels are OK.
 +
 
 +
===== Ekiga and other audio applications =====
 +
 
 +
Ekiga is capable of running simultaneously with other sound applications (like music and video players). The following directions should be enough to accomplish this:
 +
 
 +
From the '''Edit''' menu, choose '''Preferences''' → '''Devices''' → '''Audio Devices'''.
 +
 
 +
*Select "<code><nowiki>ALSA</nowiki></code>" as the audio plugin
 +
*Select "<code><nowiki>Default</nowiki></code>" as output
 +
*Select "<code><nowiki>Default</nowiki></code>" as input
 +
 
 +
Then, from the '''Edit''' menu, choose '''Preferences''' → '''General''' → '''Sound Events'''. Select "Default" as alternate device output.
 +
 
 +
* [http://wiki.ekiga.org/index.php/Getting_several_applications_using_the_sound_card_at_the_same_time_%3F Ekiga's documentation More about running Ekiga with other audio applications]
 +
 
 +
==== Webcam ====
 +
 
 +
Ekiga does not require a webcam.
 +
 
 +
* [[UbuntuHelp:Webcam| How to set up a webcam]]
 +
 
 +
===== Choosing the right webcam driver =====
 +
 
 +
The Linux kernel has two ways to communicate with video devices, the old v4l and the new v4l2. It's best to use v4l2, but some devices only support v4l.
 +
 
 +
From the '''Edit''' menu, choose '''Preferences''' → '''Devices''' → '''Video device'''.
 +
 
 +
*Try "'''v4l2'''” or "'''v4l'''” as video plugin
 +
 
 +
===== Choosing the right video device =====
 +
 
 +
If you have several video devices (like a TV card and a webcam) you will need to tell Ekiga which one to use:
 +
 
 +
From the '''Edit''' menu, choose '''Preferences''' → '''Devices''' → '''Video device'''. Change the channel number until you find the right one.
 +
 
 +
===== Test your webcam =====
 +
 
 +
To test your webcam, click the fourth of the six icons (a grey round webcam) on the left side of the main Ekiga window. If eveything is ok, you'll see the output of the webcam. If not, you'll see the Ekiga logo bouncing slowly.
 +
 
 +
=== Install the latest version ===
 +
 
 +
Ubuntu 7.10 Gutsy Gibbon ships with Ekiga version 2.0.11 (18th october 2007). Please [[UbuntuHelp:GutsyUpgrades|upgrade]].
 +
 
 +
=== Development snapshots ===
 +
 
 +
https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=Capture-Ekiga-SVN.png
 +
 
 +
You can get the latest development snapshots from [http://snapshots.voxgratia.org/ snapshots.voxgratia.org]. Installing them may solve problems you are experiencing, but be aware that the snapshots could also cause more problems. This package will install nearby your actual and stable version. The Ekiga team maintains this [http://wiki.ekiga.org/index.php/Roadmap_to_3.00 roadmap to Ekiga version 3.0].
 +
 
 +
To install, follow this directions:
 +
 
 +
To add the security [http://en.wikipedia.org/wiki/GNU_Privacy_Guard GPG] key to your portfolio, use this [https://help.ubuntu.com/community/CommandlineHowto command in a terminal]:
 +
<pre><nowiki>gpg --keyserver wwwkeys.de.pgp.net --recv-keys 52ABFCB1
 +
gpg --export --armor 52ABFCB1 | sudo apt-key add -</nowiki></pre>
 +
 
 +
[[UbuntuHelp:Repositories/Ubuntu#head-155b53308911d4d3869b3650856a41550f57f891|Add the repository for your Ubuntu version]]:
 +
* Ubuntu 7.04 Feisty :
 +
<pre><nowiki>
 +
deb http://snapshots.ekiga.net/ubuntu/ feisty main
 +
</nowiki></pre>
 +
*Ubuntu 6.10 Edgy :
 +
<pre><nowiki>
 +
deb http://snapshots.ekiga.net/ubuntu/ edgy main
 +
</nowiki></pre>
 +
* Ubuntu 6.06 Dapper :
 +
<pre><nowiki>
 +
deb http://snapshots.ekiga.net/ubuntu/ dapper main
 +
</nowiki></pre>
 +
 
 +
Install the package '''ekiga-snapshot'''.
 +
 
 +
=== Gutsy 7.10 Troubleshooting ===
 +
 
 +
==== Malformed Ekiga dialog box ====
 +
 
 +
The first time you run Ekiga, the Ekiga's configuration wizard appears; in Step 5 Ekiga detect NAT Type.
 +
 
 +
With Visual Effects enabled (Compiz), the dialog box with the results is unresizable and too small to read the results it produces.
 +
 
 +
Workaround:
 +
Disable Visual Effects, from the '''System''' menu, choose '''Preferences''' → '''Appearance''' → '''Visual Effects'''. Select "None".
 +
 
 +
Restart Ekiga.
 +
 
 +
Further informations on this bug [https://bugs.launchpad.net/ubuntu/+source/ekiga/+bug/155638 here].  
  
 
=== Edgy 6.10 Troubleshooting ===
 
=== Edgy 6.10 Troubleshooting ===
第164行: 第408行:
 
==== Ekiga crash on exit ====
 
==== Ekiga crash on exit ====
  
An awfull bug on Edgy (6.10) made [http://bugzilla.gnome.org/show_bug.cgi?id=359655 Ekiga crash on exit]. If you experience "bug buddy" showing up on exit, install [http://bugzilla.gnome.org/attachment.cgi?id=76801&action=view this package] on your system.
+
A bug in Ubuntu 6.10 makes [http://bugzilla.gnome.org/show_bug.cgi?id=359655 Ekiga crash on exit]. If you experience "bug buddy" showing up on exit, install [http://bugzilla.gnome.org/attachment.cgi?id=76801&action=view this package] on your system.
  
 
'''Please, do not send a [http://bugzilla.gnome.org/show_bug.cgi?id=359655 bug report about this issue].  Thank you.'''
 
'''Please, do not send a [http://bugzilla.gnome.org/show_bug.cgi?id=359655 bug report about this issue].  Thank you.'''
  
==== The webcam only shows grey image ====
+
==== The webcam shows only a grey image ====
  
 
[https://help.ubuntu.com/community/Webcam?#head-836881f8aaa64508507ce1f2091b24b8aead02cb Try this].
 
[https://help.ubuntu.com/community/Webcam?#head-836881f8aaa64508507ce1f2091b24b8aead02cb Try this].
第174行: 第418行:
 
=== References ===
 
=== References ===
  
* To read the Ekiga Documentation : run Ekiga and press F1 (require yelp)
+
* To read the Ekiga Documentation : run Ekiga and press F1 (requires yelp)
 
* [http://ekiga.org/ Ekiga website]
 
* [http://ekiga.org/ Ekiga website]
 
* [http://ekiga.org/index.php?rub=3 Ekiga FAQ]
 
* [http://ekiga.org/index.php?rub=3 Ekiga FAQ]
* [http://wiki.ekiga.org// Ekiga wiki]
+
* [http://wiki.ekiga.org// Ekiga online documentation]
 
* [http://www.asterisk.org Asterisk] is a full featured PABX including VoIP facitlies which complement Ekiga's capabilities.
 
* [http://www.asterisk.org Asterisk] is a full featured PABX including VoIP facitlies which complement Ekiga's capabilities.
  
'''Ekiga needs you:''' [http://mail.gnome.org/archives/ekiga-devel-list/2007-February/msg00041.html Let's spread Ekiga : volunteers ?]
+
'''Ekiga needs you.''' [http://mail.gnome.org/archives/ekiga-devel-list/2007-February/msg00041.html Let's spread Ekiga!]
 
+
 
+
=== ToDo ===
+
 
+
* Expand a lot more, do screenshots.
+
* Link into InternetAndNetworking when there's more content.
+
 
+
 
+
 
----
 
----
 
+
[[category:CategorySoftware]]
[[category:CategoryNeedsExpansion]]
+
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2007年11月22日 (四) 12:29的版本

Parent: Internet and Networking

Ekiga is the default Internet telephony (VoIP) application in Ubuntu. It lets you make audio and video calls over the Internet to people who have hardware or software that follows the SIP or H.323 standards. Ekiga also features basic instant messaging.

Ekiga has a rubust and wide support for multimedia, and is compatible with Windows Messenger and most VoIP applications. Ekiga cannot communicate with Skype because it uses proprietary technology. If you have the right SIP provider, you can also use Ekiga to place calls to any normal phone line.


Ekiga?action=AttachFile&do=get&target=ekiga.png

Desktop interoperability

Ekiga works with Linux or Windows. For Mac OS, you can use the free software xmeeting.

Ekiga is compatible with Netmeeting (H.323, windows), Windows Messenger (SIP, Windows, how to configure Windows Messenger for ekiga.net), Gizmo (SIP, multi-platform), and other programs listed on the Ekiga documentation.

Googletalk is working to implement the industry standard SIP which will make it possible to communicate with Ekiga users in the future.

First use

When you start Ekiga for the first time, the 10 step Configuration druid will help you to correctly configure Ekiga. It is strongly recommended that you complete the druid.

More help about the druid (step-by-step)

How do I get a free sip:address ? (step 3/10)

At step 3 of 10 in the druid, you'll be asked for your Username and Password. You get them by registring in ekiga.net. This will gives you a free sip:address. Choose a good Username, this is what you will be giving out to your contacts. A sip:address is a way to be reachable and to reach people. You can compare it to an e-mail address.

Please avoid specials characters for your password. Letters and numbers will do just fine.

Ekiga?action=AttachFile&do=get&target=Capture-FirstTimeConfigurationAssistant3.png

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.

Your address will be sip:[email protected]

Please press ’Forward’ after having entered all required information to continue.

How do I place a call ?

When you're done the druid and if you have an account on ekiga.net, you can call the echo test: sip:[email protected] You'll be able to check if you can reach the service (the SIP network), if your sound setup is ok (you can hear yourself with a delay) and if your webcam works (you can see yourself).

If you know the SIP address of the party that you wish to call, you may enter that adress into the sip: input box at the top of the screen and press the Connect button; eg: sip:[email protected] and pressing the Connect button would call the user at that address.

Can I use several sip:addresses ?

Yes. First you have to register to the provider (e.g. ekiga.net). Then to add your new sip:address, go to menu Edit -> Accounts -> Add

Ekiga?action=AttachFile&do=get&target=Capture-EdittheAccountInformation.png

Account name: enter the name for the Edit -> Accounts window
Registrar: ekiga.net (or another provider)
User: Your Username
Password: Your password

Ekiga.net services (free calls PC-to-PC)

Ekiga.net is a free service (no ads) based upon Free Software (SER and Asterisk) ran by the Ekiga team.

Test service

Once you're registered to http://ekiga.net, you can test your setup and line quality by dialing the echo service: sip:[email protected]

This service only works with PCMU or iLBC audio codecs, and the H.261 video codec.

Audio conference server

If you are using ekiga.net as your VoIP provider, you can access a conference server via the aliases

[For example, a group of friends could meet in conference room 1122 by dialing sip:[email protected]]

Using 501xxxx, you'll be asked for a "PIN number": dialing a number you can protect the access to your conference room or just dialing # will make this conference public.

How to place a call to other SIP providers (peering)

Peering is the term given to agreement between VoIP Service Providers which enables the users of one service to call users of another.

This is usually implemented by dialing a special prefix number and then the number of the receipitant (on the 'other' service).

With Ekiga.net, you can use SipBroker prefixes.

Here are some exemples of prefixes:

Prefix Registrar Description
*282 sip.broadvoice.com Broadvoice, do not work actually (2007 july)
*747 proxy01.sipphone.com Gizmo/SIPPhone
*393 fwd.pulver.com Freeworlddialup
*534 sip1.voipbuster.com Voipbuster
*551 sip.internetcalls.com internetcalls
*248 voip.wengo.fr Wengo

You can also use the special prefix *013 to place a call using Enum. As prefixes do not have a standard, Enum tries to solve this situation.

Some numbers you can dial using Ekiga.net:

Number Description
*[email protected] US toll free numbers (1-800) ideasip.com, search US Toll Free numbers.
*[email protected] Tell me ixcall.net (Speech recognition)
*[email protected] Wengo echo test (France)
*[email protected] Freeworlddialup echo test
*[email protected] Prato City Hall echo test (Italy)
*[email protected] Freeconferencecall.com
*[email protected] Gizmo Echo test
*[email protected] Party Line Sipphone.com
*[email protected] Voxalot.com (US) Echo test

How to search a contact in Ekiga White pages

People registered to Ekiga.net may be reached using the White Pages.

  • Open the Address Book (ToolsAddress Book), or click the address book button.
  • Select "Ekiga White pages".

You can search the White pages by name, SIP address, or location. Up to 100 results are returned for any search.

Ekiga.net button for your web page

You can easily put a button on your web page showing your status: online or offline. If you're online, the visitor can place a call using the button.

Here is what will appear on your web page:

https://help.ubuntu.com/community/Ekiga?action=AttachFile&do=get&target=button-call-me.png%7C%7Cattachment%3Abutton-offline.png%7C%

In order to use it, simply add this to your web page:

<script src=”http://www.ekiga.net/status/presence.php?user=YOUR_ID_ON_EKIGA.NET”></script>

where YOUR_ID_ON_EKIGA.NET is simply your username.

Register to a commercial VoIP provider (landline and mobile phones)

You can register to a commercial VoIP provider to place calls to normal phone line or cell phone. Ekiga allows you to register several VoIP providers.

Default provider

There is no obligation for you to use the default provider.

The default provider is Diamondcard Worldwide Communication Service, which offers these rates

      • To purchase the account, go in Tools -> PC-To-Phone Account. You absolutely need to purchase the account from the PC-To-Phone configuration window or it won't work.
      • Wait for the mail that will give you a login and a PIN.
      • Enter that login and PIN in the appropriate fields in the window and enable the PC-To-Phone service.

You are now ready to do PC-To-Phone calls at very low rates all over the world.

To dial a number, simply add "00" followed by the country code, and by the phone number you want to reach.

For example, sip:003210111111 to call number 10111111 in Belgium.

Broadvoice Support

In order to setup Ekiga to work with Broadvoice which offer those rates, use the following settings.

Figure out which proxy is closest to you:

  1. proxy.lax.broadvoice.com
  1. proxy.dca.broadvoice.com
  1. proxy.mia.broadvoice.com
  1. proxy.atl.broadvoice.com
  1. proxy.chi.broadvoice.com
  1. proxy.bos.broadvoice.com
  1. proxy.nyc.broadvoice.com

Ekiga Preferences:

  • SIP SettingsOutbound SIP Proxy: proxy.broadvoice.com
  • CodecsVideo Codecs → Disable (uncheck) video support or else you will get a codec error.

Account Information:

  • Registrar: sip.broadvoice.com
  • User: <10 digit broadvoice telephone number>
  • Password: <obtained requesting it from broadvoice support>
  • Authentication Login: <10 digit broadvoice telephone number>
  • Realm/Domain: sip.broadvoice.com or Broadworks

In the case where you need to troubleshoot, start ekiga with 'ekiga -d 4'

How to set up a Gizmo account

Gizmo offers those rates.

To subscibe an account, go here and open a Sipphone account. Then, with your account number and your password go there, you'll be prompted to choose a Gizmo name.

Now go to menu Edit → Accounts → Add

Account name: whatever you wish
Registrar: proxy01.sipphone.com
User: Your Gizmo number (1747xxxxxxx)
Password: Your password

Then try the echo test: sip:[email protected]

How to set up a Wengo account

Wengo offer this rates.

Once you've registered at https://secure.wengo.com/register/wengophone/index.php?yawl[S]=wengo.public.homePage&yawl[K]=wengo.subs_152.persistOffer&lang=eng , visit

https://ws.wengo.fr/softphone-sso/sso.php?login=YOUR-EMAIL&password=YOUR-PASSWORD

where YOUR-EMAIL and YOUR-PASSWORD are what you used when you registered your account. This will give you your real username and password:

...
<userid>Username</userid>
...
<password>Password</password>
...

Now go to menu Edit → Accounts → Add

Account name: whatever you wish
Registrar: voip.wengo.fr
User: the username from the ws.wengo.fr url above
Password: the password from the ws.wengo.fr url above

Now try the echo test: sip:[email protected]


Configuration

This section covers the configuration of Ekiga.

Network

Ekiga is able to use a STUN server. In most cases the defaults should work fine, even for users of consumer-grade firewalls.

However, for advanced users or complex setups, here is the list of ports used by Ekiga:

Protocol Port Type of port Description
SIP 5000 to 5100 UDP SIP signalling, listen port: 5060
STUN 3478 to 3479 UDP Outgoing traffic to STUN servers
H323 1720 TCP Listen port
H323 5000 to 5100 UDP gatekeepers H.323
H323 30000 to 30010 TCP H.245 channel for old implementations H.323 (Netmeeting)
Several Ekigas on a LAN

There are several programs which allow copies of Ekiga to communicate with each other; you can use a SIP proxy (like Siproxd) or a PBX (like Asterisk. Further information about Ekiga and Asterisk can be found on the Ekiga documentation), or you can use Avahi.

Avahi

Avahi is the main implementation of ZeroConf protocol under Ubuntu (known as Rendezvous or Bonjour on Mac OS X). This technology allows automatic discovery of services.

To set up Avahi, please follow the Zeroconf Howto.

Other copies of Ekiga on the LAN should appear in the Address Book (third button on the left) if you double-click on Contacts Near Me.

Sound

This section is about testing and changing the sound configuration in Ekiga.

Test your computer

The audio test in the configuration druid will show you if there is any audio problem.

In case of audio problem, to check if your computer meets the requirements for Ekiga, try this command in a terminal:

$ arecord -D plughw:0,0 -c 1 -r 8000 -f S16_LE - | aplay -D plughw:0,0 -c 1 -r 8000 -f S16_LE -

Now, speak into your microphone. You should be able to hear yourself in your headset with a small delay (approximately half a second). If it doesn't work as expected, first try to setup correctly your audio desktop configuration: make sure your microphone is not muted and the volume levels are OK.

Ekiga and other audio applications

Ekiga is capable of running simultaneously with other sound applications (like music and video players). The following directions should be enough to accomplish this:

From the Edit menu, choose PreferencesDevicesAudio Devices.

  • Select "ALSA" as the audio plugin
  • Select "Default" as output
  • Select "Default" as input

Then, from the Edit menu, choose PreferencesGeneralSound Events. Select "Default" as alternate device output.

Webcam

Ekiga does not require a webcam.

Choosing the right webcam driver

The Linux kernel has two ways to communicate with video devices, the old v4l and the new v4l2. It's best to use v4l2, but some devices only support v4l.

From the Edit menu, choose PreferencesDevicesVideo device.

  • Try "v4l2” or "v4l” as video plugin
Choosing the right video device

If you have several video devices (like a TV card and a webcam) you will need to tell Ekiga which one to use:

From the Edit menu, choose PreferencesDevicesVideo device. Change the channel number until you find the right one.

Test your webcam

To test your webcam, click the fourth of the six icons (a grey round webcam) on the left side of the main Ekiga window. If eveything is ok, you'll see the output of the webcam. If not, you'll see the Ekiga logo bouncing slowly.

Install the latest version

Ubuntu 7.10 Gutsy Gibbon ships with Ekiga version 2.0.11 (18th october 2007). Please upgrade.

Development snapshots

Ekiga?action=AttachFile&do=get&target=Capture-Ekiga-SVN.png

You can get the latest development snapshots from snapshots.voxgratia.org. Installing them may solve problems you are experiencing, but be aware that the snapshots could also cause more problems. This package will install nearby your actual and stable version. The Ekiga team maintains this roadmap to Ekiga version 3.0.

To install, follow this directions:

To add the security GPG key to your portfolio, use this command in a terminal:

gpg --keyserver wwwkeys.de.pgp.net --recv-keys 52ABFCB1
gpg --export --armor 52ABFCB1 | sudo apt-key add -

Add the repository for your Ubuntu version:

  • Ubuntu 7.04 Feisty :
deb http://snapshots.ekiga.net/ubuntu/ feisty main
  • Ubuntu 6.10 Edgy :
deb http://snapshots.ekiga.net/ubuntu/ edgy main
  • Ubuntu 6.06 Dapper :
deb http://snapshots.ekiga.net/ubuntu/ dapper main

Install the package ekiga-snapshot.

Gutsy 7.10 Troubleshooting

Malformed Ekiga dialog box

The first time you run Ekiga, the Ekiga's configuration wizard appears; in Step 5 Ekiga detect NAT Type.

With Visual Effects enabled (Compiz), the dialog box with the results is unresizable and too small to read the results it produces.

Workaround: Disable Visual Effects, from the System menu, choose PreferencesAppearanceVisual Effects. Select "None".

Restart Ekiga.

Further informations on this bug here.

Edgy 6.10 Troubleshooting

Ekiga crash on exit

A bug in Ubuntu 6.10 makes Ekiga crash on exit. If you experience "bug buddy" showing up on exit, install this package on your system.

Please, do not send a bug report about this issue. Thank you.

The webcam shows only a grey image

Try this.

References

Ekiga needs you. Let's spread Ekiga!