Cisco’s DX / MX / SX and Room Kit immersive telepresence room systems are highly customizable and configurable, providing multiple ways to integrate with room amenities like lighting, shades and projectors as well as provide customized user/presenter controls. Application developers can leverage the Cisco Collaboration Endpoint - CE API to examine meeting rooms utilization via people counting, but also initiate video calls. Join us for this overview and demo-rich session to learn how to create In-Room Controls, Javascript Macros and xAPI calls. DEVNET-2071 https://www.ciscolive.com/us/learn/sessions/session-catalog/?search=DEVNET-2071

1. #CLUS
Stève Sfartz, API Evangelist
DEVNET-2071
Integrated, Automated
Meetings Rooms with
xAPIs and Macros

2. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
/Cisco/DevNet/SteveSfartz
• API Evangelist @CiscoDevNet
• API Design,Architecture and Operations
• WebexTeams & Devices/xAPI developer
• hosted @CiscoROI Paris Innovation Center
• Node.js mainly, a bit of #golang
• Europe and all over the world
• github://ObjectIsAdvantag
DEVNET-2071
“vision without
execution is
hallucination”
-- Thomas Edison
mailto: stsfartz@cisco.com
twitter: @SteveSfartz
2

3. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
7 participants, video call & presentation in progress
https://projectworkplace.cisco.com

4. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
7 participants, video call & presentation in progress

5. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
7 participants, video call & presentation in progress
custom In-Room Controls

6. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Cisco Collaboration Devices Programmability
DEVNET-2071
Pull
data
Listen to
events
Embed
code
6

7. Agenda
© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
• Cisco Collaboration Endoint software –
CE9 programmability
• Automating with xAPI (HTTP, SSH,
jsxapi)
• Creating custom interface with In-
Room Controls
• Programming Macros
• Capabilities of cloud-registeredWebex
Devices
DEVNET-2071 7

8. Let’s meet
aWebex Room Device

9. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
https://admin.webex.com

10. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Admin UI for cloud-registered Webex Devices
https://admin.ciscospark.com/devices
DEVNET-2071
https://ip-adress/cloud-login
10

11. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Adding user credentials to access your device
https://192.168.1.34/web/localusers
• Create a local ‘integrator’ user
• Connect via SSH with the Integrator user credentials
• REQUIREMENT: local network connectivity to the device
DEVNET-2071 11

12. Room Analytics

13. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Turn on People Counting out of call
Configuration > RoomAnalytics
DEVNET-2071 13

14. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS DEVNET-2071
https://github.com/ObjectIsAdvantag/roomkit-react-map
14

15. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Interactive Live Map
https://github.com/ObjectIsAdvantag/roomkit-react-map
15DEVNET-2074
Interactive map showing
PeopleCount analytics from a
set of Room Kits
• React
• Node.js
• ‘jsxapi’

16. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Collect data from devices
https://github.com/ObjectIsAdvantag/roomkit-collector
GET / healthcheck
GET /devices
GET /devices/Workbench1
GET /devices/Workbench1/average?period=60
GET /devices/Workbench1/last
GET /devices/Workbench1/max
16DEVNET-2074
Node.js local service collecting PeopleCount events
from a RoomKit deployment,
to compute weighted averages

17. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Pull data (ssh): people count
• ssh 10.10.20.1xx (integrator/integrator)
xstatus RoomAnalytics PeopleCount
*s RoomAnalytics PeopleCount Current: -1
xcommand Standby Deactivate
xstatus RoomAnalytics PeopleCount
*s RoomAnalytics PeopleCount Current: 0
DEVNET-2071 17

18. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Pull data via the ‘jsxapi’ Node.js library
DEVNET-2071 18

19. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Troubleshooting
• Getting -1 for PeopleCount?
• EITHER your device is in Standby
• OR couting out of call is not enabled
• Update your device’s configuration
DEVNET-2071 19

20. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Listen (ssh): show clicked events
ssh 10.10.20.1xx (integrator/integrator)
xfeedback register /Status/RoomAnalytics/PeopleCount
** end
OK
*e RoomAnalytics PeopleCount Current: 14
*e RoomAnalytics PeopleCount Current: 15
*e RoomAnalytics PeopleCount Current: 13
DEVNET-2071 20

21. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
/! don’t forget to deregister
• ssh 10.10.20.1xx (integrator/integrator)
xfeedback deregisterall
DEVNET-2071 21

22. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Listen to events via the ‘jsxapi’ Node.js library
DEVNET-2071 22

23. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
xAPI
23DEVNET-2071
Listen to
events xfeedback
Invoke remote APIs
Interact with control systems

24. Branding

25. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Waking up your system (viaWebUI andTSH)
*s Standby State: Off
xcommand Standby Deactivate
http://<ip-address>/web/personalization
Other Standby commands
- xcommand Standby Activate
- xcommand Standby Halfwake
DEVNET-2071 25

26. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Personalization via Web UI & ssh
xConfiguration UserInterface CustomMessage: “Welcome to the DevNet Zone"
http://<ip-address>/web/personalization
DEVNET-2071 26

27. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Personalization via Postman
DEVNET-2071 27

28. Postman demo

29. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
To go further: import an xAPI colllection
https://github.com/CiscoDevNet/postman-xapi#integrator
DEVNET-2071
https://raw.github..../xapi-integrator.json
29

30. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Personalization: Brand logo (awake) via WebUI
*e UserInterface Branding Updated
Type: "Branding"
DEVNET-2071 30

31. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Personalization: Brand logo (awake) viaTSH
Your logo
272x272
Example:
https://www.base64-image.de/
 Turn your image (PNG, 272px272p) to base64 bytes
 Remove heading string (such as ‘data:image/png;base64’)
 Paste to the command line and hit Enter
 Add ‘.’ and hit Enter again
544523454353
BVHhe7d2/WuJ
MH8b…x4T0W
sNjLI4hCYII=
xcommand UserInterface Branding Upload Type: Branding
iVBORw0KGgoAAAANSUhEUgAAARAAAAEQCAYAAAB4CisVAAAAAXNSR0IArs4c6Q
AAAppLdq81bWeZNTvqk+uW5x7p/On5ZEcWb/pjN/uRDxGPoVINtH4xv+OG3wqZPVtK5J
b/tiTa7Ln0j37vMp7zhCQgtx9StANi/2be0yMY2dCLq9NTf1p4fdzK8apvV/sZpGD483tCyQ8
zym42zfbx3hl++=.
OK
*r BrandingUploadResult (status=OK):
** end
*e UserInterface Branding Updated Type: "Branding"
** end
DEVNET-2071 31

32. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Personalization: Brand logo (awake) via Postman
Your logo
272x272
Example:
https://www.base64-image.de/
 Turn your image (PNG, 272px272p) to base64 bytes
 Remove heading string (such as ‘data:image/png;base64’)
 Forge XML PUT request in Postman
544523454353
BVHhe7d2/WuJ
MH8b…x4T0W
sNjLI4hCYII=
DEVNET-2071 32

33. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
xAPI
33DEVNET-2071
Pull
data
xstatus, xconfig,xcommand
local network connectivity*
(coming viaWebex Cloud)

34. Creating custom
In-Room Controls

35. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS DEVNET-2071 35

36. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS

37. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS DEVNET-2071 37

38. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
In-Room Simulator
https://controls-editor.herokuapp.com/playground.html?virtualroom
38DEVNET-2071
End-to-end enrichedUser
Experience for Meeting
Rooms
• In-RoomControl
• Node.js jsxapi

39. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
https://10.10.20.1xx/web
DEVNET-2071 39

40. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
https://10.10.20.1xx/web/roomcontrol/editor
DEVNET-2071 40

41. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Customize the activity
DEVNET-2071 41

42. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Create a button with id: push_DEVNET-2074A
DEVNET-2071 42

43. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Deploy
DEVNET-2071 43

44. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Preview
DEVNET-2071 44

45. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Agenda with notifications
https://github.com/ObjectIsAdvantag/xapi-samples/tree/master/controls/agenda_notif
45DEVNET-2071
Pushes session details to a
WebexTeams space
• In-RoomControl
• Node.js jsxapi
• Incoming webhook

46. WORKSHOP DEVNET-2074
Enhancing Meeting Rooms with xAPIs
Wednesday - 10:30AM -Workshop 5

47. Macros: Maze Game

48. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Maze Game
https://github.com/ObjectIsAdvantag/xapi-samples/tree/master/controls/maze-scores
48DEVNET-2071
End-to-end enrichedUser
Experience for Meeting
Rooms
• In-RoomControl
• macro

49. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
xAPI
49DEVNET-2071
Embed
code
Javascript
Macros
All CE devices but SX10
No remote API calls*
Admin role only* (coming support for cloud-
registered, HttpFeedback)

50. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Ultrasound
https://github.com/ObjectIsAdvantag/xapi-samples/tree/master/controls/ultrasound
50DEVNET-2071
Give users control to your
devices’ Ultrasound
MaxVolume
• In-Room Control
• Macro-compatible
custom message pushed to your
devices’Touch10/DX interface as
pairing is enabled / disabled.

51. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
xAPI module at DevNet
https://learninglabs.cisco.com/modules/xapi-intro
51DEVNET-2071

52. DevNet Sandboxes

53. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Webex Room Kit
https://projectworkplace.cisco.com/#/en-us/product/webexroomkit/0/0
DEVNET-2071 53

54. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
https://developer.cisco.com/site/sandbox/
DEVNET-2071

55. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Prototype with the RoomKit Sandboxes
DEVNET-2071 55

56. Wrapup

57. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
xAPI
57DEVNET-2071
Pull
data
Listen to
events
Embed
code
Javascript
Macros
All CE devices but SX10
No remote API calls*
Admin role only* (coming support for cloud-
registered, HttpFeedback)
xstatus, xconfig,xcommand
xfeedback
Invoke remote APIs
Interact with control systemslocal network connectivity*
(coming viaWebex Cloud)

58. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Resources
• Room and Desk Devices Developer Center
• https://cs.co/roomdevices
• Web interface and API guides
• http://www.cisco.com/go/dx-docs for DX70 and DX80
• http://www.cisco.com/go/roomkit-docs for Room Kit and Codec Plus
• Postman collections
• https://github.com/CiscoDevNet/postman-xapi
• xAPI samples
• https://github.com/ObjectIsAdvantag/xapi-samples
• awesome-xapi
• https://github.com/CiscoDevNet/awesome-xapi
DEVNET-2071 58

59. Complete your online session evaluation
© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Give us your feedback to be entered into a
Daily Survey Drawing.
Complete your session surveys through the
Cisco Live mobile app or on
www.CiscoLive.com/us.
Don’t forget: Cisco Live sessions will be available for viewing on
demand after the event at www.CiscoLive.com/Online.
DEVNET-2071 59

60. © 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public#CLUS
Demos in
the Cisco
campus
Walk-in
self-paced
labs
Meet the
engineer
1:1
meetings
Related
sessions
Continue
your
education
DEVNET-2071 60

61. Q&A

62. Thank you
#CLUS

63. #CLUS