Skip to content
This repository was archived by the owner on Aug 13, 2022. It is now read-only.

Commit cfe0685

Browse files
updated collab-xapi-controls to reflect Macros for cloud-registered
1 parent 925cbc9 commit cfe0685

File tree

1 file changed

+4
-3
lines changed
  • labs/collab-xapi-controls

1 file changed

+4
-3
lines changed

labs/collab-xapi-controls/8.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# Step 8: Creating On-Board JavaScript Macros
22

3-
>Note that this step requires that your application user have the 'administrator' role ('integrator' is not sufficient). Macros are not supported on cloud-registered devices or SX10 devices
3+
>Note that this step requires that you can connect to your CE device with an 'administrator' role; 'integrator' role is not authorized to run Macros.
44
55
In the previous steps, we brought interactivity to a custom in-room control panel by leveraging the xAPI via a script running on your PC. Of course, keeping your PC powered on and connected to the local network continuously is not going to work in production! You could deploy an application server on-site with your device to host the script, however there may be a better option...
66

7-
CE v9.2.1+ gives you the possibility to deploy custom code to the device itself via the 'macro' feature. Essentially, this feature allows JavaScript code to be uploaded and run directly on the collaboration device (hosted in a secure 'sandbox' environment). This custom code can interact with the device using the exposed `xapi` JavaScript object, just as we experienced earlier with the jsxapi library.
7+
CE v9.2.1+ gives you the possibility to deploy custom code to the device itself via the 'Macro' feature. Essentially, this feature allows JavaScript code to be uploaded and run directly on the collaboration device (hosted in a 'sandbox' environment). This custom code can interact with the device using the exposed `xapi` JavaScript object, just as we experienced earlier with the jsxapi module.
88

99
Ideally, code developed on an external app server using jsxapi could be uploaded to run directly on a collaboration device without requiring an external server.
10+
Though, for security and performance reasons, the macro run-time environment does not support establishing remote network connections via the JavaScript code.
1011

11-
>Note: for security and performance reasons, the macro run-time environment does not support establishing any kind of remote network connections via the JavaScript code. You can learn more about macros in [Part 4 of CE’s Customization Guide](https://www.cisco.com/c/dam/en/us/td/docs/telepresence/endpoint/ce93/sx-mx-dx-room-kit-customization-guide-ce93.pdf)
12+
You can learn more about macros in [Part 4 of CE’s Customization Guide](https://www.cisco.com/c/dam/en/us/td/docs/telepresence/endpoint/ce93/sx-mx-dx-room-kit-customization-guide-ce93.pdf)
1213

1314
**Let's see how we can run our previously developed script on-board our device using a macro**
1415

0 commit comments

Comments
 (0)