Some Params to your video
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 |
String Params example usage:
https://player.example.com/?v=12345&color=red&controls=play,volume&title=My%20Video
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 |
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>