Jabber Guest for Android allows external (public) users to call internal enterprise endpoints and engage in two-way video communications over the public Internet. When configured correctly, the Jabber Guest web server allows guests to establish video calls that reach inside the firewall to contact support, experts, and other services from their Android device. This functionality is enabled through the Jabber Guest Software Development Kit (SDK) for Android. The Jabber Guest SDK for Android coordinates and simplifies the implementation, use, and quality of two-way video calls from within your application. This document covers the software and resources a developer would need to use the Jabber Guest SDK to integrate into their Android mobile applications.
This document is intended for developers or information technology professionals using or familiar with Cisco telecommunications equipment who want to integrate with their Jabber Guest web server by using a mobile device. The document assumes the reader is comfortable with Java for Android, common Android design patterns, and object-oriented design in general.
This section covers terminology in use within the SDK and components of the SDK itself.
The Call Bar is a view that has on-screen controls for the user to modify the state of an active call. By default, these buttons include things like Mute, Stop, Keypad, and End Call.
A Remote View is a view that represents the called party's video during an active call.
A Self View is a view that represents the local user's transmitted video during an active call. The Self View can be presented full-screen during the set up of a call to allow the user to see themselves prior to initiating the call. During a call, the Self View is often shown as a smaller view over the Remote View to allow the user to continue to see what the called party can see.
A URI is a Uniform Resource Identifier that is used to identify and potentially pass arguments of the targeted called party.
For full descriptions and method or properties definitions, refer to the API Reference documentation for more information.
The JabberGuestCall class is a singleton that consolidates the lifecycle and interaction with a Jabber Guest call. It represents all of the capabilities and state of the active or pending call. For example, muting and unmuting video is controlled through this class. Getting information such as whether or not video is active or what state the call is in can be accessed through this state through registered notifications. In addition, call statistics are also available.
The CallFragment class is a packaged collection of visual components working together to give developers a quick and easy way to integrate common Jabber Guest call functionality into their application. It includes a RemoteView, SelfView, and ControlBarView in a common configuration.
Similar to the CallFragment class, the PreviewFragment class is intended for developers to quickly include a baseline of functionality when using the Jabber Guest SDK for Android. This class give developers a way to show a SelfView with a call button.