Customize Web Player
Prerequisite: Allow anonymous web players
Customizing the web player through URL & query parameters is only available when anonymous web players are allowed.
Enable it in Settings → General → Player → Allow anonymous web players.
When this setting is disabled, web players can no longer connect through a public playlist URL. Only registered players paired with a code can access content. The query parameters described below have no effect in that case.
Obscreen provides an URL for each playlist.
Player's playlist URL is configurable in two ways:
Playlist URL
To connect the player to a specific playlist using its IDhttp://<STUDIO_URL>/use/<playlist_id>
Playgroup URL
To connect the player to a specific playgroup using its IDhttp://<STUDIO_URL>/group/<playgroup_id>
Playlist always starts with an introduction slide showing date & time (customizable). Then it plays the first content item and endlessly loops through the playlist items according to the schedule.
Query Parameters Options
You can use the following query parameters to configure the player through url parameters (e.g. http://<STUDIO_URL>/?intro=0&autoplay=0&animation_effect=slide&animation_speed=normal&animation_direction=left&loop=0):
intro
Default value: 1
Description: Show the introduction slide or not
Available values: 0 or 1
rotate
Default value: normal
Description: Set the rotation of the player display
Available values: normal, left, right, inverted
transparent
Default value: 0
Description: Make the player background transparent or not
Available values: 0 or 1
bgcolor
Default value: 000000
Description: Set the background color
Available values: Any valid CSS color value without # prefix (e.g. 000000, FFFFFF, FF0000, 00FF00, 0000FF, etc.)
animation_effect
Default value: none
Description: Set the animation effect
Available values: slide, fade, zoom or none
animation_speed
Default value: normal
Description: Set the animation speed
Available values: slow, normal or fast
animation_direction
Default value: normal
Description: Set the animation direction (for slide effect only)
Available values: left, right, up or down
autoplay
Default value: 0
Description: Enable/disable video autoplay or not
Available values: 0 or 1
interactive
Default value: 1
Description: Enable/disable user interaction or not
Available values: 0 or 1
loop
Default value: 0
Description: Number of times the playlist will loop
Available values: Any positive integer or 0 for infinite loop
debug
Default value: 0
Description: Enable debug mode or not
Available values: 0 or 1