Web SDK - Player runtime parameters


While the main Player experience is controlled using the settings defined in your Player configuration, additional runtime customization is achievable using client-side parameters.

Check the dedicated guide to see how to add runtime Player parameters with each embed method of the Web SDK.



ParametersDefaultDescriptionType
videoundefinedThe ID of the video to load.string
playlistundefinedThe ID of the playlist to load.string
aspectRatioundefined

The aspect ratio of the Player.

Possible values: 16:9 4:3 1:1 3:4 9:16 or inherit

string
customConfigundefined

Define advertising configuration by passing in keys and values. More details.

E.g. customConfig[key]=values

object
loopfalse

To set the video to loop. More details.

Possible values: true or false

boolean
scaleModefit

To adjust the player’s video focus.

Possible values: fit fill fillLeft fillRight fillTop fillBottom

enum
startTime0Specify the time (in seconds) from which the video should start playing.number



video

The ID of the video to load.

Typedefault value
stringundefined

playlist

The ID of the playlist to load.

Typedefault value
stringundefined

customconfig

Define advertising configuration by passing in keys and values. More details.

E.g. customConfig[key]=values

Typedefault value
objectundefined

scalemode

To adjust the player’s video focus.

Possible values: fit fill fillLeft fillRight fillTop fillBottom

Typedefault value
enumfit

startTime

Specify the time (in seconds) from which the video should start playing.

Typedefault value
number0

loop

To set the video to loop. More details.

Possible values: true or false

Typedefault value
booleanfalse