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
- Log in to your KMC and navigate to the Studio > Kaltura Player Studio tab.
- Create a new Smart player or select an existing player from the table and open its Edit View.
- 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.
- Object: config.playback.inBrowserFullscreen
- Type: boolean
- Value: Default is false
How to configure the Full Screen
- Go to the Player's Advanced Settings tab.
- Hover over the playback object and click on the + icon. to add the followings:
- Name [boolean]: inBrowserFullscreen
- Value= true
- 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.
- Object: config.ui.components.seekbar
- The URL for the preview thumbnail image.
- Object: config.ui.components.seekbar.thumbsSprite
- Type: string
- Value: Possible values:
'', custom url
Default value for OVP only is '{POSTER_URL}/p/{PID}/sp/{PID}00/thumbnail/entry_id/{ENTRY_ID}/version/100042/width/{THUMBS_WIDTH}/vid_slices/{THUMBS_SLICES}'
see example http://cdnbakmi.kaltura.com/p/4834032/sp/483403200/thumbnail/entry_id/1_aaa551bq/def_height/480/def_width/640/vid_slices/92
Passing an empty string will disable the thumbnail on the seek bar.
-
The width of each preview thumbnail slice.
- Object: config.ui.components.seekbar.thumbsWidth
- Type: number
- Value: Default is 164
- The height of each preview thumbnail slice.
- Object: config.ui.components.seekbar.thumbsHeight
- Type: number
- Value: Default is 92
-
The number of slices that the preview thumbnail image will divide into.
- Object: config.ui.components.seekbar.thumbsSlices
- Type: number
- Value: Default is 100
Volume
Defines the initial volume value. For the viewer guide, see Playback Functionality.
- Object: config.playback.volume
- Type: number
- Value: Default is 1 [The value must be in the range of 0-1]
Example:
var config = { playback: { volume: 0.5 } };
How to configure the volume
- Go to the Player's Advanced Settings tab.
- 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]
- 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.
- Object: config.playback.playbackRates
- Type: Array <number>
- Value: The default value of this property is 1.0
How do you configure the playback speed?
- In the Player Studio, click on a player to open its Player Settings window.
- Scroll to the end of the page and select Advanced Settings.
- The Advanced Configuration opens where you can add objects, values, and arrays.
Click on the plus icon near the playback object: - Type in the name:
playbackRates
, after that click on the edit icon: - Remove the null value and set the array like:
[0.5, 1, 1.5, 1.75, 2, 3]
The result looks like this
-
Click Save.
Audio language
Sets the default audio track language.
- Object: config.playback.audioLanguage
- Type: String
- Value: The default value of this property is "Auto"
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
- Go to the Player's Advanced Settings tab.
- 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.
- 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 totrue
, 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 tofalse
, a user action will be required to start playback.
How to configure the Autoplay
- Go to the Player's Advanced Settings tab.
- 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.
- Click Save.
Autopause
The field Indicates whether the video should be automatically paused when not in view.
- Object: config.playback.autopause
- Type: boolean
- Value: The default value of this property is false.
How to configure Autopause
- Go to the Player's Advanced Settings tab.
- Hover over the playback object and click on the + icon. to add the following:
- Name [text]= Autopause
- value = true/false/in view
- 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:
- Go to the desired player's Advanced Settings tab and locate the "provider" object in the settings list.
- Click the green (+) button next to "provider" to add a new property.
- In the Key Name popup that appears type vrTag
- Click the green check mark to complete the action.
- Click the pencil (edit) icon next to the red "null" value.
- Delete "null" and type your custom tag, for example, my__360__tag (do not add quotes - the system will add them automatically).
- Click the green check mark to save your changes.
- Click Save at the top right of the settings window.
Now the VR button will only appear for videos that specifically have the tag you set, preventing incorrect playback in VR mode.
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.