Query Params

These are the query parameters that can be used to set configurations for a specific video.

UUID Params

Table for "UUID" type query params - UUID (Universally Unique Identifier) is a 128-bit identifier used to uniquely identify resources. The table lists the UUID query params available for setting specific configs to the player.

Param	Type	Default	Description
*v	UUID	none	Video ID
l	UUID	none	Library ID

String Params

Table for "String" type query params - The table lists the String type query params that can be used to configure the player, such as color, controlsColor, and title.

Param	Type	Default	Description
color	String	# 4874F1	The primary color of the player
controlsColor	String	# FFF	The color of controls and menus
title	String	-	Video title
controls	String	play-large,play,progress,current-time, volume,captions,settings,pip,cast,fullscreen,airplay, rewind,fast-forward	A list of enabled controls
thumbnail	String	auto generated	Thumbnail URL
pauseThumbnail	String	generated on the frame it was paused on	Thumbnail URL (pause)
endThumbnail	String	last frame of video	Thumbnail URL (end)
watermark	String	-	The watermark that appears on the video
drm_group_id	String	-	Force use a watermark group
mutedIndicatorTextTop	String	-	Muted indicator text that appears at the top
mutedIndicatorTextBottom	String	-	Muted indicator text that appears at the bottom
saveProgressTitle	String	'Você já começou a assistir esse vídeo'	Title of the save progress page
saveProgressButton1Title	String	'Continuar assistindo'	Title of the first button on the save progress page
saveProgressButton2Title	String	'Voltar ao início'	Title of the second button on the save progress page
customName	String	-	Custom identifier to group user sessions
initQuality	String	-	Sets the initial quality at which the video will start
defaultSubtitle	Srtring	-	Defines which subtitle language will be automatically selected when the player loads. The value must match the language code of an available subtitle track in the video (e.g., en, pt, es).

String Params example usage:

https://player.example.com/?v=12345&color=red&controls=play,volume&title=My%20Video&initQuality=720p

Boolean Params

Table for "Boolean" type query params - Boolean values are either true or false. The table lists the Boolean type query params available for setting configs like autoplay and muted.

Param	Type	Default	Description
autoplay	Boolean	false	Autoplay on load
muted	Boolean	false	Video init on muted mode
saveProgress	Boolean	true	Save video watch progress
preload	Boolean	true	HLS preload enabled
mutedIndicatorIcon	Boolean	false	Muted indicator is enabled
alternativeProgress	Boolean	false	Fictitious progress bar
hideControlsOnStart	Boolean	false	Hide controls before play
restartAfterEnd	Boolean	false	Restart at the end
troubleshootDialog	Boolean	true	Right click
disableForward	Boolean	false	Disable click to advance or go back
playOpensFullscreen	Boolean	false	Play opens in full screen
smartAutoplay	Boolean	false	If true, the player will try to play with audio before showing the muted indicator
startsWithSubtitle	Boolean	false	Defines whether the player should start with subtitles enabled or disabled when the video loads.

📘
Difference between autoplay and smartAutoplay
The autoplay query param is used to automatically play a video on load, but with the muted indicator enabled. On the other hand, the smartAutoplay query param tries to play the video with audio before showing the muted indicator. If the video can be played with audio, it will run normally, but if not, the muted indicator configured for the player will be displayed. Therefore, smartAutoplay gives a better user experience as it attempts to play the video with audio before falling back to the muted indicator.
For SmartAutoPlay to work via parameter, AutoPlay must also be added.

Boolean Params example usage:

https://player.example.com/?v=12345&autoplay=true&muted=true&saveProgress=false&hideControls=true&restartAfterEnd=true

Number Params

Table for "Number" type query params - Number type query params are used to set numerical values, such as the font size for captions or the default video speed.

Param	Type	Default	Description
alternativeProgress2xLimit	Number	20	The limit in % that the progress bar will run at a different speed
alternativeProgressVelocity	Number	5	The speed of the progress bar
alternativeProgressHeight	Number	0	The height of the progress bar
saveProgressBackgroundOpacity	Number	1	Opacity of the save progress page background
captionsFontSize	Number	20	Subtitles font size (px)
defaultSpeed	Number	1	Default video speed
startTime	Number	0	Time in seconds that the video will start

📘
availableSpeeds
0.5, 0.75, 1, 1.25, 1.5, 2

Number Params example usage:

https://player.example.com/?v=12345&captionsFontSize=24&defaultSpeed=1.5&alternativeProgress2xLimit=30&alternativeProgressVelocity=10&alternativeProgressHeight=8

More Usages

<iframe id="panda-player" src="https://player-vz-6a0bfc2c-30b.tv.pandavideo.com.br/embed/?v=13337fdb-db1c-436b-b888-4908c433feba&saveProgress=false&controls=play-large,progress"
    style="border:0;width:720px;height:480px"></iframe>