|Columbia SIP User Agent||CU IRT|
User manual for sipc version 2.0
On Windows machines, users can simply run 'setup.exe' to install
If a user is running sipc for the first time, the 'Preference' dialog will pop up to ask the user to input the configuration information. A user can always change the configuration information by using 'File/Preference' menu item.
All the configuration information are saved in the $HOME/.sipc directory. The following is the description of the files in the $HOME/.sipc (on Windows, in C:\Documents and Settings\<user>\.sipc) directory.
http://www.alsa-project.org. Note: you will need root access to the machine to run some/all of these commands! This has been tested on IBM A30 laptop running Linux.
Sipc can be started by clicking on its icon or from the command line. In addition, sipc can also be invoked from a web browser.
sipc [-call immediately|manual] [-audio] [-video] [-wb] [-subject string] [destination-address]
At the main interface, to make a call, a user needs to input the callee's URL in the location entry, then click on the call button (). For every outgoing call, the user can choose to use a specific service (outbound proxy) to make the call. To choose a service, the user can select from the service combobox, which is at the end of the tool bar.
An outgoing call must have at least one media checked in the media frame,
by default, an outgoing call is an audio-only call. By default, audio,
video, and white board communications are both way. For desktop sharing,
when a user check the media icon, the user needs to choose the
mode to decide whether to
By clicking the
To expediate calling process,
To add a speed dial button, a user can use the menu item
After adding a speed dial button, users can also edit the information
of the speed dial by
right clicking on the speed dial button,
then choose the
If a user want to use phone pad digits, e.g., a calling card call may require the user to input card number and password, the user can click on the 'Phone pad' bar and gets a phone pad (the text on 'Phone pad' bar will be changed to 'Hide phone pad'). The user can then click on the digits in the phone pad and have DTMF tones generated. To hide the phone pad, the user can simply click the 'Hide phone pad' bar.
When an incoming call arrives at sipc, the 'New call' dialog box will be popped up. A user can choose to accept the call , explicitly reject the call, or ask the caller to make a call at a later time. The user can also block the caller so all the calls from this caller will be automatically rejected. The blocking status can be turn on or off from address book.
A user can also click on the
Once the callee accepts the call, the title of the call tab will show the name of the caller.
To terminate a call, a user can simply click the
By clicking the button,
From the "Services menu item", a user can add a new service to or maintain existing services.
If the user chooses
If a user wants to do additional configuration on the contact information or want to upload some service scripts to the registrar, the user can click on the 'More Settings' button to invoke the "More settings" dialog. From the dialog, the user can add more contact information, set the expiration time of the account, or upload service scripts. Sipc bases on the suffix of the filename to decide the type of the service script. If the suffix is '.cpl', the service script will be considered a CPL script, otherwise, the service script will be considered a SIP CGI script.
Once a user adds a contact, the contact will be listed in the contact list. The contacts are grouped into different groups. A user can click on the to hide the detail of the group, and click on the to show the detail. The user can place the mouse over a contact to see the SIP URI of the contact.
For each contact, the user can watch the contact's status. If the user is online, the icon will be displayed before the contact, otherwise, the will be displayed and the contact's name is grayed.Right click on a contact, a user can perform several functions on a contact.
Handle incoming subscriptions
When sipc receives a subscription, if sipc already starts to provide presence status information to the party sending the subscription, sipc will automatically accept the subscription and then send the current status to the subscriber. If sipc is not providing presence status to the subscriber, sipc will pop up a Incoming subscription" window asking for the user's approvance. The user can accept, deny or block the subscription. If the subscription is accepted or blocked, the subscriber will be added to the contact list so that the user can modify the contact's state (blocked or accepted) later.
The main interface of addressbook lists the name, the nickname, the organization, the SIP URL and the last call made by the user. There are two columns used for presence status, , which indicates whether a user listed in the address book has subscribed to the owner of the address book; and which indicates the status of the user that has been subscribed by the owner of the address book. A user can click on each column title to sort the list based on the title the user clicks.
When a user right click on an entry of the addressbook, a popup menu will be displayed. The user can perform some actions such as making a call, sending email, doing subscription, controlling device and sending an instant message to the selected address entry.
A user can add or edit the address record through the addressbook interface. The address edit interface contains three categories of information, namely 'Name' information, which provides basic user identifying information; 'Contact' information, which provides postal contact information; and 'Services' information, which provides some simple policies associated with the SIP address.
sipc can detect and edit the end user's location information and
pinpoint a buddy on a map if the buddy releases its location information.
To retrieve and edit location information, a user can use
If a user choose the
Location information can be civil location and geographic location. Civil location attributes include building name, floor information etc. These attributes are also defined in a map file for matching. A map file can be a HTML file. Click here for a map file example. The map dialog is shown below. If sipc has a buddy's picture, it will show the picture on the map. Otherwise, it just shows the buddy's name on the map.
With civil location,
Some very useful features for the map dialog are performing actions on a room.
By right clicking on a room, users can see all possible actions for the
room. Users can send an announcement to all the buddies in that room,
invite all the buddies in that room to join a conference, or send an
email to all the buddies in that room.
A user can click the button to add a new service, or right click on an existing service to edit or delete the existing service.
When adding a new service, the service properties dialog will first pop up asking for the name and description of the service.
When the service decision tree has been built, users can click the
If a user's machine can support multicast, with using sipc, the user can receive session information announced over Internet by Session Announcement Protocol (SAP). The following shows the sessions received by sipc.
The user can select the session, choose the media and click on the 'Join Session' button to join the session. The joined sessions can be listed in the 'Joined sessions' frame. From the frame, the user can choose a session and quit the session.
Right click on a session entry, the user can perform several functions based on the session information. The user can watch the detailed information of the session, can watch the SDP description of the session, or invite another user to watch the same Internet TV session.
Invite another user to watch the same Internet TV session
If a user choose the 'Invite someone for session' function, a dialog will popup. The user can input the SIP address of the remote party and choose the media type and then send the invitation out.
Sipc can control the network appliances via the device gateway such as
SIP-X10 device gateway. There are different kinds
of devices, every kind of devices may have different control commands. The
control commands for a specific device type are saved in
monitoring interface to watch the SIP messages. A user can choose "Tools/Monitor" menu item, or type the