Requirements

This section describes the requirements for implementing a Jabber Guest for Android solution.

Jabber Guest Server

The version of SDK to be used must match the server version that will be servicing clients.

Supported Devices

The miminum Android software requirements for any device is Android 4.0.3 (API Level 15) or later.

The minimum Android hardware requirements are as follows:

Jabber Guest SDK does not support the Tegra2 chipset.

Devices tested and supported:

For support of other Android devices, consult the Cisco Support Forums at http://supportforums.cisco.com if you encounter problems with unsupported devices.

Due to the media-heavy nature of the SDK, development and use on an actual device is required.  No known emulator will properly capture and render audio and video with the Jabber Guest SDK.

Android Software Development Kit (SDK)

For development, the Jabber Guest for Android SDK requires a current Android SDK be installed and that a minimum Android platform API level of 15 is available for use.  If you do not have the API 15 package installed, go to the Android SDK Manager and install the SDK Platform for Android 4.0.3 (API 15).  This also means that any device support is limited to Android 4.0.3 and later.

Required Manifest Entries

Ensure your manifest specifies the following uses-feature and uses-permissions sections to guarantee the functionality and capabilities required by Jabber Guest.

Required Android Features

Feature usage statements in the manifest are required to ensure the proper OpenGL version and hardware features needed for Jabber Guest to operate correctly.

OpenGL

OpenGL is required to guarantee a high-quality video display.
<uses-feature android:glEsVersion="0x00020000" />

Camera Features

Because Jabber Guest uses the camera, several features involving the camera are required of a device. 
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-feature android:name="android.hardware.camera.front" />
<uses-feature android:name="android.hardware.camera.back" />

Audio Features

In addition to camera features, Jabber Guest uses the microphone to record audio from a device. Ensure your manifest specifies the following uses-feature sections: <uses-feature android:name="android.hardware.microphone" /> <uses-feature android:name="android.hardware.audio.low_latency" />

Required Android Permissions

If you would like to embed Jabber Guest functionality into your application, a group of permissions must be agreed to by the user for Jabber Guest to work properly.

Recording and Transmission

The CAMERA and RECORD_AUDIO permissions are needed to capture audio and video and the permission to access the INTERNET is used to negotiate and transport the video and audio streams to the {JABBER_GUEST_PROXY} over the internet. 
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />

Network State

Jabber Guest uses the ACCESS_NETWORK_STATE permission to react and operate properly to conditions where the network is unavailable or is changing. 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Bluetooth

To access and use Bluetooth devices for audio recording and playback, Jabber Guest needs the BLUETOOTH and MODIFY_AUDIO_SETTINGS permissions. 
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

Read Phone State

The READ_PHONE_STATE is used by Jabber Guest to get the unique device ID of the device. 
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Emergency Number Notice

IMPORTANT NOTICE
911 NOTICE

During an emergency, softphone technology may not provide the most timely or accurate location data if used for a 911 emergency call. Calls may be misdirected to the wrong emergency response center or the emergency response center may make errors when determining your location. USE A SOFTPHONE ONLY AT YOUR OWN RISK DURING AN EMERGENCY.