DEVNET-1121 Customizing Cisco Video Access for Guests

Customizing Cisco Video
Access for Guests
Darin Dunlap
Senior Product Manager
Collaboration Technology Group (CTG)
DEVNET-1121

• Introduction
• Product Highlights
• Solution Components
• Call URL Management & API
• SDK’s & Demonstration
• Get Started
Agenda

Disclaimer
The Cisco products, service or features identified in this document may not
yet be available or may not be available in all areas and may be subject to
change without notice. Consult your local Cisco business contact for
information on the products or services available in your area. You can find
additional information via Cisco’s World Wide Web server at
http://www.cisco.com. Actual performance and environmental costs of
Cisco products will vary depending on individual customer configurations
and conditions. This is a confidential Cisco Internal launch document and
not for external distribution.

• Calls to individual employees,
experts, customer care
• SDKs for Web & mobile app
integration
• Available since June, 2014
• UC/video sessions into businesses …
from desktop browsers, mobile clients
• Initiate from public web sites, mobile
applications & URLs, e.g. email
Jabber Guest – Public-to-Enterprise Communications
Guest/Public
User
Enterprise
User

Jimmy Kimmel Live!
Wall of America … Powered by Cisco
Fans, celebrities appear
on the show
using Jabber Guest
integrated into the
Jimmy Kimmel Live!
portal
Wall of America on The Broadcast

Many Segments to Date … & More to Come!
Showing in The Cisco Booth & Online
Avengers Cast & Fans
Tax Edition
Will Smith & DJ Jazzy Jeff
Brave Shop
Cashier
Viola Davis
Interview
Show & Tell,
Ricky
Schroeder
National Pancake
Day
Kobe Bryant & Fans
Jimmy Kimmel Debuts Wall of America with Kevin Hart & Eddie Murphy

High-level Architecture
Consumer Business
Jabber Guest
virtual machine
E n t e r p r i s e
Public Internet
Cisco UCM or
Business Edition
Expressway

Browser & Mobile Experiences (“off the shelf”)
• Video
Point-to-point video
Point to video conference
• Midcall control
Keypad, mute audio or video, full-screen video
Camera, audio device selection
Self-view
• Call control – WebRTC compatible
• Media
Browser add-on (desktop web), Native apps (mobile)
Future – WebRTC for media
User Experience
* Images for illustration purpose only. Final UI subject to change.
Sales Department

WebRTC Vision
Vendor A
Browser
With Web
App X
Vendor B
Browser
With Web App
X
Native,
Zero PluginApps
• Native video in the browser
• ZERO install
• Standards still evolving at IETF, W3C
• Jabber Guest call control designed to be
WebRTC compatible
• Video codec support agreed Nov ‘14
• Media interop requires client &
infrastructure enhancements
HTML5 Standard – In Progress

Jabber Guest SDKs
Customization
• Desktop browser SDK
Sample HTML and Javascript provided to create
video widget and set up event handler
• Mobile native application SDK
iOS framework … Android library
Includes sample projects, tutorials, API reference, etc
• Developer enablement via Cisco DevNet …
http://jabberdeveloper.com

Jabber Guest 10.5 - What’s New …
Android
Client, SDK
available
Chrome Integration
(Non-NPAPI)
64-bit support
New iOS8 Client
HD Send Enabled
64-bit client, SDK
UCCX/UCCE/PCCE
Certified
Other Updates: Calls to VCS-registered endpoints via CUCM
Mac OS Yosemite (10.10) support
Quality, security enhancements
NEW
Q4CY14/
Q1CY15

64-bit Jabber Guest SDK & App for iOS
• As of Feb 1, 2015, new App Store
apps must be 64-bit, built with iOS 8
SDK
• Existing apps have until June 1, 2015
• Jabber Guest SDK for iOS (10.5.4)
supports these requirements
• Jabber Guest for iOS (10.5.4) in the
App Store is also 64-bit
• SWIFT-based sample apps also
provided with the SDK (10.5.4)

Jabber Guest 10.6 - What’s Next….
Other Features: BE6000 server support, e.g. BE6000M (M3), for 10.x
Enhancements to Web client accessibility
Quality, security enhancements
BFCP Screen
Share (Receive)
G.722 Wideband
Codec Support
Web UE Enhancements
Self View Control
NEW
Q2CY15

Example Call Flow
Expressway/VCS
Core X8.2+
Expressway/VCS
Edge X8.2+
Home Internet DMZ Enterprise
Cisco® UCMJabber® Guest
HTTPS-based
call control (ROAP)
SIP
RTP/SRTP
STUN/TURN
• Serves up Javascript call control based on URL
• For mobile, uses Cisco® app from app store or integrates SDK into third-party app
• For laptop browsers, initiates H.264 add-on install as needed (Cisco or 3rd-party Web app)
• Converts HTTPS call request to SIP INVITE
Jabber Guest …

Contact Center and Jabber Guest
Expressway CoreExpressway Edge
Home Internet DMZ Enterprise
Jabber®
Guest
• UCCE 10.0 in Remote Expert 1.9 … PCCE 10.5
• UCCX 10.5 validated up to 100 sessions
• Video in Queue through MediaSense
• Rich video experience, including HD
Contact Center and Jabber® Guest …
UCCE/PCCE/UCCX
Cisco
UCM
MCU
Cisco UBE,
VXML-GW
MediaSense
HTTPS-based
call control (ROAP)
SIP
RTP/SRTP
STUN/TURN

Using Jabber Guest with Cisco Context Service
Customer
Context Service
Customer-facing App
Back End*
Agent
E n t e r p r i s e
Jabber Guest
virtual machine
UC Manager,
Business Edition
Expressway
CVP/UCCE,
PCCE, UCCX
1. Customer-facing app puts
interaction data into CS
3. Call setup to contact center
using Guest call link …
interaction created in CS,
data (POD ID) passed to
CC
2
2
* could alternatively be on-prem
1
3
3
3
Finesse
4
4
4
2. Customer-facing app, via
its back end, gets unique
Guest call link for the
customer, e.g. using
customer’s phone #,
account ID or email as the
identifier
4. Call routed to agent … POD
ID passed to Finesse, loads
customer/context data from
CS

Example of Partner Integration with Jabber Guest
Video of Vyopta Integration

Call URL Configuration
• Administrator configures URL
• URL string, call destination, caller name, active time, etc.
• Some examples …
• URL dialing: https://example-
jabberg.com/call/janedoe@example.com
• 8-digit domain name: https://example-
jabberg.com/call/12345678@example.com
• Custom: https://example-
jabberg.com/call/ServiceDepartment
• “Jabber Guest API” is the server-side RESTful API for
programmatic URL management
• “Ad-hoc” calling can be used for a more open approach

“Timed” URL Configuration
• A time-bound call link may be created
• Link only valid during time specified in admin console
• Helps manage time of in-house expert
• Jabber Guest API may be used to manage links & timing
from third party scheduling software

Jabber Guest API
• Restful API provided to create, update, delete call URL’s, as well as retrieve information about links
• Script for bulk management of links using this API is available on DevNet
• The API can return or retrieve data in either application/json or application/xml
• API use is supported at a rate of once per second … support for database size of 20,000 call URLs
Resource Description
GET https://[IP address]/cjg-api/rest/links/ Returns a list of links and the properties for each
link. Parameters:
• limit—The number of items to limit the list to.
• offset—The offset into the full result list to start
this list at.
Examples of limit and offset for paging links:
• Gets the first 10 links (page 1): /cjg-
api/rest/links?limit=0&offset=10
• Gets the next 10 links (page 2): /cjg-
api/rest/links?limit=10&offset=10
GET https://[IPaddress]/cjg-
api/rest/links/[linkObjectId]
Takes a linkObjectID and returns the object
properties for the specified link.

Jabber Guest API (cont.)
POST https://[IPaddress]/cjg-api/rest/links/ Create a new link
Content-Type: application/json
Body: {“isEnabled”: true,
“requestPath”: “AnyValueYouWant”,”destination”:
“johndoe@cisco.com}
The requestPath value must be unique. You also need
to pass in the isEnabled flag or the link will be disabled
Resulting Link:
https://[server]/call/AnyValueYouWant
PUT https://[IP address]/cjg-api/rest/links/[linkObjectId] Update Link
Content-Type: application/json
Body: { “is Enabled”: true,
“requestPath”: “AnyValueYouWant”,
“destination” johndoe@cisco.com }
The requestPath value must be unique. You also need
to pass in the isEnabled flag or the link will be disabled.
Resulting link:
https://[server]/call/AnyValueYouWant
DELETE https://[IP address]/cjg-
api/rest/links/[linkObjectId]
Delete the specified link.

Jabber Guest API (cont.)
Property Description
linkObjectID Unique identifier for a link
isEnabled The status of the link. This flag must be passed in
when creating or updating a link or the link will be
disabled.
requestPath The part of the link after /call. For example,
https://[linkPrefix][requestPath]. Must be unique.
destination DN or URI that is called when a user clicks on the
link. Destination is required.
displayName The name displayed on the client when placing a
call using this link. Optional.
callerName The name displayed on the destination endpoint
in the enterprise when a call is placed using this
link. Optional.
Property Description
callerAlias The Caller ID displayed on the destination endpoint
in the enterprise when a call is placed using this
link. Optional.
validAfter The date and time when a link becomes active.
Default value: If left blank, the link can be used
immediately to route calls. Optional.
validBefore The date and time when a link expires, and can no
longer be used to route calls. If left blank, the link
never expires. Optional.
linkPrefix The part of the link before the request path.
linkPrefix is the same for all links in a cluster.
userObjectId The user responsible for creating the link.
Default: If left blank, defaults to the logged-in user.

API in Action
Get Links Create Link Lookup Link Delete Link

Simple to Embed Video in Web Apps
• Jabber Guest functionality is exposed on a web page by
embedding the application widget
• The widget can be embedded using an iFrame, e.g. …
<div>
<iframe id="jabberg"
src="https://jabberguest.mycompany.com/call/1000?widget=true">
</iframe>
</div>
• Widget displays error messages and responds to events, e.g.
use an “onmessage” listener in the parent window
• Navigating away from the active call page will end the call – to
prevent a user accidently closing an active call, Jabber Guest
will first prompt the user to confirm the close
• There is a widget sizing tool located at …
https://<server>/call/widget-size.html

Simple to Embed Video (cont.)
• Hyperlink under “join” button may be seen below.
• Notice “?widget-true”. Video only widget, i.e. no additional web page

Overview of Jabber SDK for iOS
Jabber Guest SDK for iOS includes …
• An iOS framework that packages libraries and
available APIs
• Sample projects that help you walk through
the supported integration scenarios
• Documentation that includes tutorials and API
references

iOS Integration Scenario – Simplest Approach
High Level: Use Pre-packaged View Controller (1/2)
The SDK provides a view controller class which handles all Jabber Guest functionality for
you. You just need to instantiate the view controller and segue to it from your own UI.
Call
Live Video
Support
Your app’s UI
Live Video
Support
Your app’s UI
CJGuestCallViewController
Preview
In Call
View

iOS Integration Scenario – Simplest Approach
High Level: Use Pre-packaged View Controller (2/2)
• Required Classes
Class Name Description
CJGuestCallViewController The high level Jabber Guest view controller that controls the entire call
CJGuestViewControllerDelegate Protocol that handles events when end call / More button was pressed, or
Invalid certificate was received from Jabber Guest server
Name Description
NSString * serverName Jabber Guest server address
NSString * toURI SIP URI of the remote end point
Name Description
callFinishedForCallController called when the end call button was pressed or disconnect occurs
moreButtonPressedForCallController called when the More button was pressed
• Properties that have to be set before segueing
• Protocol methods need to be implemented before initiating the segue
• Set its delegate

iOS Integration Scenario – Greater Customization
Low Level: Custom Views (1/2)
Instead of letting the view controller take care of everything for you, you can use the main
Jabber Guest class together with the pre-packaged view subcomponents to build your own
custom solution.
Your app’s UI Live
Video
Support
Remote
Video:
remoteView
Self Video:
selfView
Call Bar View:
CJGuestCallBar
View

iOS Integration Scenario – Greater Customization
Low Level: Custom Views (2/2)
CJGuestCall A singleton, represents the lifecycle of a single entire call.
CJGuestCallBarView call bar customized view
CJGuestCallBarViewDelegate protocol that handles event when a button on the view was pressed
Name Description
Class method sharedInstance this method returns the active call instance
Instance methods startCall call this method to establish a call
endCall call this method to end the call
Properties NSString * serverName Jabber Guest server address
NSString * toURI SIP URI of the remote end point
IBOutlet UIImageView * remoteView represents the called party’s video during an active call
IBOutlet UIImageView * selfView represents the local user’s transmitted video during an active call
• Key methods and properties in CJGuestCall
• Key notification event to register
CJGuestStatChangeNotification: Register for this event to be notified when the call state changes

User Activation of Cisco H.264 AVC in 3rd-party iOS Apps
• To be covered by Cisco’s H.264 license &
royalty payments to MPEG-LA, third parties
must use the SDK for iOS/Android “activation”
mechanism in their apps
• Users must “Activate” one time before calls
will work
• Third parties that use the SDK for iOS in their
apps without the Cisco activation mechanism
will need to license H.264 from MPEG-LA
and pay them royalties
Third-party App
Calls Activated in Third-party App

Jabber Guest SDK for Android includes …
• An Android library that wraps all available
Jabber Guest APIs
• A couple of sample projects that help you walk
through the supported integration scenarios
• Documentation that includes tutorials and API
references
What does the SDK for Android offer?

The SDK provides an activity (JabberGuestCallActivity) using two pre-packaged fragments
(PreviewFragment, CallFragment) that combine typically needed views for you based on call state.
JabberGuestCallActivity
Android Integration Scenarios – Simplest Approach
High Level: Use Activity (1/3)
Your app’s UI
Live Video support
Call
Your app’s UI
Live Video support
Preview
In Call
View

JabberGuestCall the main singleton class that consolidates the lifecycle and interaction with a Jabber Guest call
JabberGuestCallActivity 1 a packaged Android activity that automatically controls SDK fragments (PreviewFragment or
CallFragment) shown based on current conditions of the call … see docs for attributes, etc
Name Description
createInstance create and return an instance
getInstance get an existing instance
createUri create and return a Uri in the format that createInstance expects
RegisterReceiver register a given BroadcastReceiver to be notified when supported events occur
registerInvalidCertificateHandler 2 registers an implementation of JabberGuestInvalidCertificateCallback interface
• Key static public member methods in JabberGuestCall class
1 Always associated with an instance of JabberGuestCall
2 Note that if you do not register an implementation of this interface, if the JabberGuestCall instance encounters a certificate error the instance will
reject the invalid certificate and terminate any pending call immediately.

• Key intents sent to registered BroadcastReceivers
Name Description
start initiate the call to the toUri specified in the createInstance method
end end this call and release all resources associated with this instance
registerContext provides a context to display dialog windows when necessary
acceptInvalidCertificate accept the invalid certificate
rejectInvalidCertificate reject the invalid certificate
• Key public member methods in JabberGuestCall class
• Key states of a JabberGuestCall instance
Name Description
State enum type: { GuestCallStateDisconnected, GuestCallStateConnecting,
GuestCallStateConnected, GuestCallStateDisconnecting }
Name Description
ACTION_INSTANCE_AVAILABLE sent when a new instance of JabberGuestCall has been created.
ACTION_CALL_STATE_CHANGED sent when a state change occurs in a JabberGuestCall instance.
ACTION_CALL_CONTROL_EVENT sent when a new call control event is generated in a JabberGuestCall instance.
ACTION_CALL_ERROR_EVENT sent when an error event occurs in JabberGuestCall instance.

Your app’s UI Live Video
Support
Android Integration Scenarios – Greater Customization
Low Level: Use Custom Views (1/3)
Instead of using fragments, you can take the subcomponent themselves, like the RemoteView,
SelfView, and CallBarView, to create your own custom solution.
Self Video:
SelfView
Remote Video:
RemoteView
Call Bar:
CallBarView

Android Integration Scenarios – Greater Customization
JabberGuestCall the main singleton class that consolidates the lifecycle and interaction with a Jabber Guest call.
PreviewView a view that represents the local user's video before a call is placed
RemoteView a view that represents the called party's video during an active call
CallBarView a view that represents controls that can alter the functionality of an active call
SelfView a view that represents the local user's transmitted video during an active call.
KeypadView a view that represents a telephone keypad during an active call
Name Description
createUri create and return an Uri in the format that createInstance expects.
1 Note that if you do not register an implementation of this interface, if the JabberGuestCall instance encounters a certificate error the instance will reject
the invalid certificate and terminate any pending call immediately.

Customization
Name Description
Name Description
getState Retrieve the current state of this JabberGuestCall instance
Nam
e
Description
State enum { GuestCallStateDisconnected,GuestCallStateConnecting,GuestCallStateConnected,GuestCallStateDisconnecting }

SDK in Action …
DEVNET-2011 (Thu, 11:30)
Jabber Guest SDK for Android
Live Coding Tutorial

Summary
Key Take Away – Imagine the possibilities
• Expand your business reach and cut costs
• Enhance customer interactions
• Make experts easy to find
• Improve interactions with partners, suppliers
Additional Resources
• Customers: Visit Cisco.com/Go/JabberGuest
• Developers: Visit Jabberdeveloper.com
• EAP/Beta: Via Customer Connection Program
• BRKUCC-2086 Extend the Reach of Your Cisco
Video Solution with Jabber Guest

Continue Your Education
• Visit the World of Solutions for demos
• Jabber area
• Customer Experience area
• Visit the DevNet Zone for …
• Learning Labs
• Hackathon
• DEVNET-2011 … Jabber Guest - Android SDK Live Coding Tutorial
• Sandbox demo pod
• Visit DevNet online for on-going developer resources … http://jabberdeveloper.com
• Attend related sessions …
• BRKUCC-2086 … Extend the Reach of Your Cisco Video Solution with Jabber Guest
• LABCOL-2400 … Jabber Guest Implementation with Expressway
• TECCOL-2888 … Designing and Deploying A Secure Enterprise Edge Solution for Collaboration
• BRKUCC-2801 … Cisco Expressway at the Collaboration Edge Design Session

Complete Your Online Session Evaluation
Don’t forget: Cisco Live sessions will be available
for viewing on-demand after the event at
CiscoLive.com/Online
• Give us your feedback to be
entered into a Daily Survey
Drawing. A daily winner
will receive a $750 Amazon
gift card.
• Complete your session surveys
though the Cisco Live mobile
app or your computer on
Cisco Live Connect.

Screen Share to Jabber Guest 10.6
From Jabber Windows/Mac & Video Endpoints with BFCP Sharing
• Web browsers on Windows, Mac
• Shared content replaces far-end video ...
show/hide self, far-end view
• iOS & Android smartphones, tablets
• Swipe between shared content & far-end view
… toggle self view in either … zoom/pan

• Cisco-provided client in Google
Play store
• Native Android SDK on DevNet
(http://jabberdeveloper.com)
• Same capabilities as Jabber Guest
for iOS
• exception: HD video transmit
• Same 3rd-party device support as
Jabber for Android 10.6 (details in
slide notes)
Jabber Guest for Android (10.5.3)
Smartphones Tablets

New Architecture, Experience for Google Chrome
• Addresses Chrome dropping
NPAPI plugins
• Required for 64-bit Chrome on
Windows & Mac
• Chrome changes require using
both an extension & a native “add-
on”
• Video is in a native window
automatically overlaid on top of the
browser window
• SDK is also supported
Sales Department

The SDK provides two pre-packaged fragments that combine relevant views for you, which can be used
directly if greater customization is needed versus using the “high-level” approach.
PreviewFragment CallFragment
Android Integration Scenarios
Medium Level: Use Pre-packaged Fragments (1/3)
Your app’s UI
Live Video support
Call
Your app’s UI
Live Video support
Preview
In Call
View

JabberGuestCall the main singleton class that consolidates the lifecycle and interaction with a Jabber Guest call
PreviewFragment 1 a packaged collection of visual components allowing developers to show a SelfView with a call button
CallFragment 1 a packaged collection of visual components working together to give developers a quick and easy way
to show a two-way video call. It includes a RemoteView, SelfView, and CallBarView
Name Description
createUri create and return a Uri in the format that createInstance expects
1 Always associated with an instance of JabberGuestCall
2 Note that if you do not register an implementation of this interface, if the JabberGuestCall instance encounters a certificate error the instance will
reject the invalid certificate and terminate any pending call immediately.

Name Description
Name Description
State enum type: { GuestCallStateDisconnected, GuestCallStateConnecting,
GuestCallStateConnected, GuestCallStateDisconnecting }
Name Description

Collaboration Cisco Education Offerings
Course Description Cisco Certification
CCIE Collaboration Advanced Workshop (CIEC) Gain expert-level skills to integrate, configure, and troubleshoot complex
collaboration networks
CCIE® Collaboration
Implementing Cisco Collaboration Applications
(CAPPS)
Understand how to implement the full suite of Cisco collaboration
applications including Jabber, Cisco Unified IM and Presence, and Cisco
Unity Connection.
CCNP® Collaboration
Implementing Cisco IP Telephony and Video
Part 1 (CIPTV1)
Implementing Cisco IP Telephony and Video
Part 2 (CIPTV2)
Troubleshooting Cisco IP Telephony and Video
(CTCOLLAB)
Learn how to implement Cisco Unified Communications Manager, CUBE,
and audio and videoconferences in a single-site voice and video network.
Obtain the skills to implement Cisco Unified Communications Manager in a
modern, multisite collaboration environment.
Troubleshoot complex integrated voice and video infrastructures
CCNP® Collaboration
Implementing Cisco Collaboration Devices
(CICD)
Implementing Cisco Video Network Devices
(CIVND)
Acquire a basic understanding of collaboration technologies like Cisco Call
Manager and Cisco Unified Communications Manager.
Learn how to evaluate requirements for video deployments, and implement
Cisco Collaboration endpoints in converged Cisco infrastructures.
CCNA® Collaboration
For more details, please visit: http://learningnetwork.cisco.com
Questions? Visit the Learning@Cisco Booth or contact ask-edu-pm-dcv@cisco.com

DEVNET-1121 Customizing Cisco Video Access for Guests

More Related Content

What's hot

Viewers also liked

Similar to DEVNET-1121 Customizing Cisco Video Access for Guests

More from Cisco DevNet

Recently uploaded

DEVNET-1121 Customizing Cisco Video Access for Guests

Editor's Notes