Jabber Guest for iOS 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 iOS device. This functionality is enabled through the Jabber Guest Software Development Kit (SDK) for iOS. The Jabber Guest SDK for iOS 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 iOS 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 Objective-C for iOS and common iOS design patterns.
This section covers terminology in use within the SDK and components of the SDK itself.
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.
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 CJGuestCall 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.
This view has on-screen controls for the user to modify the state of an active call. These controls include things like Mute, Stop, Keypad, and End Call.
A DTMF keypad that can send digits to the targeted called party.
This view encapsulates the Self View, including the ability to switch cameras and control orientation.
The CJGuestCallViewController 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 Remote View, Self View, and a Call Bar in a common configuration.
The framework is designed with flexibility in mind. The framework can be split into three levels.
Apps should make use of the mid-level views and CJGuestCall to integrate Jabber Guest.
There is a sandbox environment that is free and publicly available for test purposes. The server name is jabberguestsandbox.cisco.com and the URI is 5555.