When you make a request to start a new screen share, the JSON content that you get back will contain a
viewerUrl. You can integrate the viewer by either redirecting the user to the
viewerUrl or embedding the
viewerUrl into an
The viewer can be customized by adding optional query string parameters to the
|fitToWindow||By default, the screen share renders for the viewer at the actual size, to ensure
the highest quality image. To resize the screen share to fit within the user's browser display area,
set this option to
|showStop||If this parameter is set to
|showResize||If this parameter is set to
|externalId||You may now pass in an external ID of up to 32 characters to save with the viewer data in a screen share. This can be useful for later connecting screen share viewer connections to records on your system.|
|redirectOnError*||A URL to which the user should be redirected if there is an error. If omitted, an error message is displayed.|
|redirectOnEnd*||A URL to which the user should be redirected when the screen share ends. If omitted, a message is displayed to inform the user that the screen share has ended.|
|language||The code of the language in which to translate viewer messages. By default, Screenleap will attempt to pick up the correct language from the "Accept-language" HTTP header.
The currently available languages are listed below. To request a language not already on the list, please contact support.
iframe; this option would need to be used for a full-window viewer.
Viewer Customization Wizard
The API demo lets you try out
each of the customization options above. We recommend that you click
Show viewer options on the demo page, use it
to find the configuration that will work for you, then copy the URL from that page to use in your