Working with ohphoneXOn this page, you find information in how to use ohphoneX in everyday use.
The ability to store the preferences in Locations is a new feature introduced in ohphoneX 0.3. Its goal is to ease the usage of ohphoneX within different networks. The new architecture also allows a much more flexible handling of callto URL's and Phonebook entries.
Suppose you are using a PowerBook or iBook and want to make audio/video conferences with ohphoneX. Your company hosts a gatekeeper and other people call you by entering your office phone number. Sometimes, you want to make audio/video conferences at home but want still use the gatekeeper service. The problem is: at home, you have a LAN with private ip addresses, bridged via a NAT to the rest of the internet. If you want ohphoneX to register at your company's gatekeeper from home, you need to enable IP Address Translation. Eventually you don't have the same bandwidth at home as at your work, so you'd like to change some of the audio/video settings as well.
Everytime you want to do that, you need to change some of your preferences. This is not a confortable situation and
can be quite frustrating, especially when done regularly.
In the preferences window, you have a pop up button at the top of the window view. There you can set which Location you want to edit. The list also contains an element for adding a new Location and an element for editing the list of Locations itself (renaming & deleting Locations). The images below show this.
When you have video receive enabled in Preferences, the main window of ohphoneX will look as follows when in a call:
The text field where you can enter the remote party's name has been replaced by the remote video image. The small image in the drawer at the right side shows the local video from your webcam. Pressing the small arrow button at the right bottom of the main window shows/hides this drawer.
You also have the chance to specify a still image which will be sent whenever video capturing is stopped - provided you have enabled video transmission. This may be helpful if you have a low-bandwidth connection but you still want to show other people some sort of image.
This window provides you with detailed information about which codecs are used, the current bitrate of the audio/video streams and some additional information concerning network quality.
These informations can be really useful if you need to optimize your settings, investigate bugs etc.
What are Callto URLs?
Callto URL Syntax
The general syntax of a callto-URL is:
"callto:/ADDRESS+type=TYPE" whereas ADDRESS is the address to call and TYPE is one of these four types described above. The type phone is the default one, so if no type is specified, the address will be treated as a phone address.
If the remote party at ADDRESS listens under a different port than a the default H.323 port, you can use the following callto-URL syntax:
The slash after the callto: string is optional and actually not part of the callto-URL specification. However, in some occasion this slash is needed to "trick" around some WebBrowsers such as Safari. They tend sometimes to interpred the callto-URL as a natural HTTP-URL.
When TYPE is ip, ohphoneX makes a direct call, not using a gatekeeper. If TYPE is phone, a gatekeeper is required to resolve the phone number. Normally, the default gatekeeper (the one specified in Preferences) is used. In some occasions it is necessary to use a different gatekeeper than the default one. In this case, you may add a "+gatekeeper=GATEKEEPER:PORT" to the URL. (PORT is here optional as well)
When using a different gatekeeper, eventually it is also necessary to use a different username and / or phone number as well. For this calse, ohphoneX will understand "+username=USERNAME" and "+phonenumber=PHONENUMBER" as well.
Note: These last three additions to callto-URLs are not part of the original callto-URL specification from Microsoft. ohphoneX will understand them and interpret them correctly, but other clients most probably won't. It is also very unlikely that you will encounter a situation where these additions useful. In most cases, you don't need to use them.
Examples of callto-URLs
Using callto-URLs with ohphoneX
ohphoneX integrates Support for Apple's Address Book API. For each record in Address Book, you can add the required informations for making H.323 calls to this person. Internally, this is done by using callto-URLs (see section above) so that potentially other H.323 clients also have access to these informations.
For users which don't use Apple's Address Book for storing their addresses, ohphoneX provides a way to add simple records to the Address Book database without having to launch the Address Book application itself. The data is still stored in the Address Book database, though.
When launching the Address Book, you will not see the callto-URL entries. Only ohphoneX does extract them from the database and display them on screen.
Using the Phone Book
You can browse your records, search for matches etc. If you want to call the selected record, either press the Call this Person button or simply press the Return key.
Editing Phone Book Records
Pressing the Edit in Address Book button launches the Address Book application
and allows you to edit the general settings of the selected user such as name, streed,
phone number etc. You cannot change the Callto-URL from within Address Book.
The Call Type pop up list allows you to define the type of the callto-URL. If you specify No Callto-URL, ohphoneX will not store any callto-URL for this record. Existing callto-URL entries for this record will be deleted. By choosing Direct Call or Using a Gatekeeper, you can specify which type of calls you make to this person. When using a gatekeeper, you also have the options to specify another gatekeeper / username / E.164-Number as the default ones. (specified in Preferences)
Adding a new Record