Access to virtual screens is done either directly by navigating to a URL within a browser or by using “Go To” actionable that are presented in Vizzi white label frontend web app.
The URLs for accessing the virtual screens follow the syntax below:
https://hostname/path/[screenID]/{{userID}}/{{collectionID}}/{{itemID}}
- Hostname: enter the hostname of your Vizzi deployment;
- Path: enter the path to the virtual screen page as specified in your Vizzi deployment. Usually, the default is “vscreen”, if in doubt, please contact MOG;
- [screenID]: mandatory, must match a Virtual Screen ID that has been previously configured in Vizzi;
- {{userID}}: mandatory, identifies the owner of the screen. Can be set explicitly, or with “{{userID}}” macro in case of usage within Vizzi white label fronted, leveraging actionable var replacement mechanism. Note that this macro resolves differently for each logged user;
- {{collectionID}}/{{itemID}}: optional, identifies the collection and the collection item that will be available on the virtual screen;
There are two ways to define these variables:
- Explicitly: with their IDs generated by Vizzi. Explicit IDs can be consulted using the item edit view;
- By macros: with the “{{collectionID}}" and "{{itemID}}” macros, activating the variable replacement mechanism, if the content has been defined when creating the virtual screen (step 5, chapter "Configuring Virtual Screens").
If the content is defined when creating the virtual screen, Vizzi will consider the item specified in the URL only if it is part of the chosen collection. If the content was not chosen when creating the virtual screen, the item specified in the URL will be considered.
Note: the {{itemID}} can be omitted, in which case the owner can choose which items will play from items belonging to {{collectionID}}.
- Adding the snippet
“?gotoOpenPolicyWeb=_self” at the end of the URL, means that in the frontend, when the customer clicks on the button created by the actionable, the video preview page will be opened in the same browser tab, otherwise, it will be opened in a new tab.
- https://example.com/vscreen/5f27d55354fa4bbe0c8d2774/5f27d51d54fa4b28f38d2773/
- https://example.com/vscreen/5f27d55354fa4bbe0c8d2774/5f27d51d54fa4b28f38d2773/5f22f868a98d4843aa409da7
- https://example.com/vscreen/5f27d55354fa4bbe0c8d2774/5f27d51d54fa4b28f38d2773/5f22f868a98d4843aa409da7/5f22f743a98d481f0f409da5