This chapter gives an overview of the voice chat feature and explains the procedure to configure this feature in Instant Messenger. This chapter contains the following sections:
Instant Messaging provides its users the capability to talk to each other by using a PC-based audio hardware. The Instant Messaging client uses the Instant Messaging server to set up the call. The client uses the XEP-0166-Jingle protocol for VoIP in which the audio streams travel in peer-to-peer (p2p) signals. For more information about the XEP-0166-Jingle protocol, see http://www.xmpp.org/extensions/xep-0166.html.
This feature does not support interactions with other VoIP providers.
To enable this feature, select the Enable Audio option while deploying the Instant Messaging Client resources. After you select the Enable Audio option, you can chat and start the voice chat session. This feature enables only peer-to-peer chat. The voice chat option does not exist in a conference chat.
Once you configure the Instant Messenger, you cannot enable or disable the Enable Audio option. To make any changes to this option, reconfigure Instant Messenger by invoking the init-config command.
The Audio Pane is available at the bottom right of the Lower Message pane in the Instant Messaging client interface. This pane contains icons that can be used to initiate and end voice conversations with other users. The audio pane contains the following items:
Initiate a call: Click this icon to initiate an audio chat with other users.
Hang up: Click this icon to end an audio chat.
To initiate a voice chat, do the following:
- Start the text-chat session.
- Select the user from the participation list. The Initiate a call icon is enabled.
- Click the Initiate a call icon.
The other user gets a request to accept the call. Once the user accepts the call, they are in connected status. The user can use the Hang up icon to end the call.
There is no option to record or archive a voice chat conversation.
A common issue with a client-to-client communication is the network and client-level firewalls that block incoming connections to random ports.
The voice chat feature uses an initial TCP client-to-server session to negotiate the client-to-client UDP VoIP link. The current voice chat feature does not have a method to restrict the UDP ports that are used on the clients that accept the connection.
One indication that a firewall might be blocking the establishment of the VoIP link is when the client which initiates the VoIP connection sees "Trying..." for 10 seconds and then a "Call Ended" message is displayed even though the incoming voice chat request was accepted by the other client.
To enable the Instant Messaging Client debug option, add the <argument> debug=true </argument> parameter in the im.jnlp file. The debug information appears in the Java Console output.
If VoIP is enabled, the audio pane is available at the bottom right of the Lower Message pane of the chat window. If VoIP is not enabled during configuration, the audio pane is not available in the chat window.
There is currently no method to enable or disable the VoIP feature at a user or domain level.