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 version 7.3 provides the users of Instant Messaging 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 problem with client-to-client communication the is network and client-level firewalls that block incoming connections to random ports.
The Voice Chat mechanism uses an initial TCP client-to-server session to negotiate the client-to-client UDP VoIP link. The current Voice Chat mechanism does not have a method to restrict the UDP ports that are used on the client accepting the connection.
One indication that a firewall may be blocking the establishment of the VoIP link is 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> line in the im.jnlp file. Debug information then appears in the Java Console output.
If VoIP is enabled, the audio pane is available at the bottom right of the Lower Message pane in 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.