Jabber Web SDK

Jabber Voice and Video FAQs

This section provides FAQs on the following topics:

Jabber Voice and Video

Can I use the Jabber SDK softphone to sign in to multiple computers at the same time?

No. Signing in to multiple computers is currently not supported. For the softphone to function correctly, you must sign out on one computer before you sign in to another computer.

Can I use the softphone on multiple instances of a browser?

Yes. You can run the softphone on maximum of three browser tabs.

Can I use a headset with the softphone?

Yes. However, you must first ensure that your headset is selected in the audio preferences of your operating system. If you use a headset that is plugged into a USB port, do not unplug the headset and then plug it in again. This results in disruption of the audio portion of your call.

Can I have multiple conversations at the same time?

Yes. The Jabber SDK supports multiple conversations. You specify the number of simultaneous multiple conversations in the Directory Number configuration on Cisco Unified Communications Manager.

Can I use the softphone if I'm already using a similar type of phone on my computer?

Yes. You can use the Jabber SDK softphone with the following clients:

  • Cisco Jabber

  • Cisco Unified Personal Communicator

  • Cisco Unified Communications Integration for Microsoft Office Communicator

  • Cisco UC Integration for Webex Connect

  • Cisco Unified IP Communicator

    If you experience dropped calls or unable to make a call, contact your administrator. In this situation, it is likely that a device conflict exists on the Cisco Unified Communications Manager.

I'm on a call with someone who is using an analog landline. Why doesn't my call end when the other person hangs up?

Some phone companies do not pass the end-of-call message to Cisco Unified Communications Manager. As a result, the Jabber SDK phone does not receive any event to indicate that the call ended. Instead, the Jabber SDK phone might receive a TempFail event. This issue has not been seen with external digital devices such as cell phones.

Jabber sometimes selects the wrong microphone. How can I control this?

It is not currently possible for you to select audio input and output devices. You can disable devices, such as a microphone, that you do not want to use through your computer's control panel. However, doing so disables that device for all applications. Direct control over audio and video devices will be available in a later release.

Why my headset microphone does not work for Webex meetings when I use video?

USB camera microphones take precedence over headset microphones if you enable video for a Webex meeting. This issue might also occur for other applications that reassign audio input devices.

When I lose network connectivity while on a call, why are some features disabled even after Jabber recovers the call?

During a call, the Jabber SDK connects to the following on the network:

  • Cisco Unified Communications Manager

  • The other endpoint

    The network connection to the other endpoint carries the audio on a media stream. If Jabber loses the media stream and then recovers it, the call continues as normal. However, if Jabber loses the connection to the Cisco Unified Communications Manager, it is not possible to perform call control activities other than ending the call. If Jabber loses the connection when either side of the call is on hold, it is not possible to resume that call when the network is restored.

Every few minutes, my phone loses connectivity, dropping calls and preventing me from making new calls.

This issue is likely the result of another softphone using the same device as the Jabber SDK softphone on Cisco Unified Communications Manager. Contact your administrator to resolve this conflict.

Microsoft Windows

I get a "TFTP Fetch Error". I'm using Microsoft Windows and my Cisco Unified Communications Manager account is set up for the Jabber SDK.

The Microsoft Windows firewall or other security product might be preventing the browser process from communicating using TFTP. In the firewall, set Mozilla Firefox, Internet Explorer, Chrome, and Safari as exceptions.
Alternatively, disable the firewall. Contact your system administrator for assistance.

Mac OS X

Why can I get only one-way audio when I use Bootcamp to run Windows XP on my Mac?

The drivers you installed might be causing this issue, particularly if you experienced this issue with other phones on your computer in addition to Web Communicator. You might resolve this issue if you upgrade Bootcamp 3.0 drivers to version 3.1.

Can I plug and unplug my headset at any time?

No. The Jabber SDK softphone works if the headset is plugged-in, when the web page is loaded. If you plug the headset in or unplug it, you can reload the page (using F5) and force the softphone to detect the new hardware setup.

How can I get my headset microphone, which is plugged in to my Mac microphone port, to work?

The Mac requires a powered microphone. As a result, headset microphones do not work when they are plugged directly into the Mac microphone port. However, you can use a USB adaptor for the microphone to avoid this problem. Before running the Jabber SDK softphone, plug in a USB adaptor and connect the microphone to it. Connect the headset jack to the line out port of the Mac. In the hardware section within the Mac system preferences, select Sound, and then select the Input tab. Then select the USB audio device in use.

How can I get the audio to work on my Mac when I'm using the Jabber SDK softphone over Cisco VPN?

The Cisco VPN client does not allow incoming RTP (audio) streams. Use the OSX native VPN client (available on OSX 10.6 and later), or use a VPN from a different vendor, instead.

Browser Plugins

Mozilla Firefox

Can I use a plugin called IE-Tab that allows me to run Microsoft Internet Explorer inside a Mozilla Firefox tab?

No. Do not use the Jabber SDK softphone with the IE-Tab plugin.

Configuring IM and Presence

How do I enable IM and Presence in my application?

  1. Change CAXL httpBindingURL to your own CUP server IP address.
    For example in sample.html
    jabberwerx._config.httpBindingURL = "[http://myserver:9080/caxl"

  2. Modify the domain to be the same as your CUP server's. Change the variables jid and remotejid in sample.html

What CUP versions are supported?

CAXL 8.5 supports CUP 8.5 and higher versions.

Known Issues

Retrieval of held calls when in passive mode

If you place a call using Web Communicator, place it on hold, and then resume on a desk phone, the phone call is said to be in "passive mode." A 'Call Failed' message appears if you attempt to make other calls in Web Communicator while the call is still active on the desk phone. Web Communicator is currently limited to supporting a single call. Even when you resume the call on a desk phone, this call is still associated with Web Communicator. If you put the call on hold on the desk phone, you can resume it again in Web Communicator.

Temp Fail behavior

When on a call, the error message TempFail signifies that the Jabber SDK softphone is no longer able to detect audio from the remote party. This is usually because of a network failure or a problem with the audio hardware on the remote end of the call. Under certain conditions (for example, the remote party has no microphone) the Jabber should raise the TempFail error from the start of the call, but sometimes does not.

iDivert

Invoking endConversation(true)

(In other words, diverting the call) when voicemail is not configured in Cisco Unified Communications Manager, it requires a browser refresh before the user can make further calls. In desk phone mode, if you divert the call, the desk phone will continue to ring.

Community

Visit the Jabber Developer Forums to ask questions and interact with other developers. Forums

Next