Player - Advanced settings

Last Modified on 02/25/2025 9:39 am IST

About

The Advanced Setting widget allows you to manually edit the player configuration by adding/removing properties that are not exposed in the studio interface.
This guide demonstrates several examples of how to control the core capabilities of the Kaltura player via advanced settings.

Access the advanced settings

  1. Log in to your KMC and navigate to the Studio > Kaltura Player Studio tab. 
  2. Create a new Smart player or select an existing player from the table and open its Edit View. 
  3. At the bottom of the Player Settings tab, select Advanced Settings.
    The Advanced Configuration window is displayed.

Full screen

Gives the ability to choose an in-browser fullscreen experience. For the viewer guide, see Full Screen.

Useful on iOS devices which will replace the native fullscreen of the AV player.

How to configure the Full Screen

  1. Go to the Player's Advanced Settings tab.
  2. Hover over the playback object and click on the + icon. to add the followings:
    • Name [boolean]: inBrowserFullscreen
    • Value= true
  3. Click Save.

To disable entering to full screen by double clicking the player, see config.components.fullscreen.disableDoubleClick.

Seek bar

Defines the seek bar component optional configuration.

Passing an empty string will disable the thumbnail on the seek bar.

Volume

Defines the initial volume value. For the viewer guide, see Playback Functionality.

Example:

var config = {
  playback: {
    volume: 0.5
  }
};

How to configure the volume

  1. Go to the Player's Advanced Settings tab.
  2. Hover over the playback object and click on the + icon. to add the followings:
    • Name [text]: volume 
    • Value: must be between 0 to 1 [0-1]
  3. Click Save.

The following graphic demonstrates the player's Advances Settings with the volume set to 0.5.

The following graphic demonstrates the player volume set to 0.5.

Speed

Sets the available rates at which the media can be played back. This is an Array attribute that is used to implement user controls for fast forward, slow motion, and so forth. The normal playback rate is multiplied by this value to obtain the current rate, so a value of 1.0 indicates normal speed. For the viewer guide, see Playback Functionality.

How do you configure the playback speed?

  1. In the Player Studio, click on a player to open its Player Settings window.
  2. Scroll to the end of the page and select Advanced Settings.

  3. The Advanced Configuration opens where you can add objects, values, and arrays.

    Click on the plus icon near the playback object:

  4. Type in the name: playbackRates, after that click on the edit icon:

  5. Remove the null value and set the array like:
    [0.5, 1, 1.5, 1.75, 2, 3]

    The result looks like this

  6. Click Save.

Audio language

Sets the default audio track language.

Example:

var config = {  playback: {    audioLanguage: 'eng' // Start playback with english audio  }
};

If the value "auto" is set, i.e:

var config = {  playback: {    audioLanguage: 'auto'  }
};

If an audio track with the defined language exists, this audio track will be selected as the initial audio track.

How to configure the Audio Language

  1. Go to the Player's Advanced Settings tab.
  2. Hover over the playback object and click on the + icon. to add the following:
    • Name [text]= audioLanguage, 
    • value = en for English / es for Spanish / etc.
  3. Click Save.

The following graphic demonstrates the default audio track set to English. 

The following graphic reflects the player audio language selector.

Using multi-audio tracks requires configuring a designated audio flavor for each language under the account transcoding profile priorly. This configuration requires PS setup; please get in touch with your CSM for assistance.

Autoplay

Start playback automatically.

  • Object: config.playback.autoplay
  • Type: boolean
  • Value: The default value of this property is false.
    If set to true, playback will start automatically when the player receives the content.
    If set to 'inview', playback will start automatically when the player is in view.
    If set to false, a user action will be required to start playback.

How to configure the Autoplay

  1. Go to the Player's Advanced Settings tab.
  2. Under the playback object, hover over the Autoplay object and click on the + icon. to edit the settings:
    • If set to True ('Always') - The video will play automatically when the page loads.
    • if set to 'In View' - the video will play automatically only if the player is in view. If a player is not in view, playback will start only when the viewer scrolls to it.
    • If set to False ('Off') - (default) the video will NOT play automatically and wait for user interaction.
  3. Click Save.

Autopause

The field Indicates whether the video should be automatically paused when not in view.

How to configure Autopause

  1. Go to the Player's Advanced Settings tab.
  2. Hover over the playback object and click on the + icon. to add the following:
    • Name [text]= Autopause
    • value = true/false/in view
  3. Click Save.

Video resolution

When using the Kaltura Player exclusively in Safari on Mac, in order to adjust video resolution, you must insert a section into Advanced settings called "preferNative".  

Once "preferNative" is added, video resolution adjustment may be performed as follows: 

Custom error message 

Go to How to custom the player error message.

Custom tag for VR mode

By default, the Kaltura Player enables VR mode for any video tagged with 360 (or variations). However, some videos may automatically receive this tag (like technical or math-related ones), even if they aren’t 360° videos, causing playback issues.

To change the tag that triggers VR mode:

  1. Go to the desired player's Advanced Settings tab and locate the "provider" object in the settings list.

  2. Click the green (+) button next to "provider" to add a new property.

  3. In the Key Name popup that appears type vrTag

  4. Click the green check mark to complete the action.
  5. Click the pencil (edit) icon next to the red "null" value.

  6. Delete "null" and type your custom tag, for example, my__360__tag (do not add quotes - the system will add them automatically).

  7. Click the green check mark to save your changes.

    8. Now the VR button will only appear for videos that specifically have the tag you set, preventing incorrect playback in VR mode.

  8. Click Save at the top right of the settings window.

 Make sure all relevant videos in your account are updated with the new tag. Only videos with this tag will trigger VR mode.

For more details on configuring VR playback, see 360 & VR.

Was this article helpful?
Thank you for your feedback!
User Icon

Thank you! Your comment has been submitted.

In This Article
Related Articles
Back to top

Never miss a thing!

Subscribe to our customer newsletter and our release notes updates, so you always get the best out of Kaltura.
Newsletter