Player configuration

Flowplayer Native can be configured in great detail through the following options. This applies to both the cloud-hosted player (ie iframe or async Javascript embed codes which can obtain from the video management page and the manual Javascript player setup with token

For the cloud player, some of those options can be preset in the player configurator; you can explicitly override them with the following configuration options

OVP managed async player

The configuration is appended to the JSON configuration object inside the embed code:

  • Flowplayer-hosted video
<div data-player-id="cdcc4202-ef0b-4e03-a43a-d1fcf6d83157">
<script src="//cdn.flowplayer.com/players/ffdf2c44-aa29-4df8-a270-3a199a1b119e/native/flowplayer.async.js">
{
  "src": "f576651c-4cc6-4664-84fa-bb3b35ef1aba",
  "my_option" : "my_value"
}
</script>
</div>
  • Self-hosted video
<div data-player-id="cdcc4202-ef0b-4e03-a43a-d1fcf6d83157">
<script src="//cdn.flowplayer.com/players/ffdf2c44-aa29-4df8-a270-3a199a1b119e/native/flowplayer.async.js">
{
  "src": "//edge.flowplayer.org/bauhaus.m3u8",
  "my_option" : "my_value"
}
</script>
</div>

my_value stands as an example for the top-level configuration objects.

In JSON syntax, all options like "src", "tracks" etc must be quoted.

Manual Javascript setup

For Javascript installs, the configuration is added to the flowplayer() call in the second argument:

flowplayer('#player_container', {
    src: "my_video.mp4"
  , token: "<my_token>"
  , title: "my video"
  , autoplay: true
})

Configuration options

Core player configuration

    • Option
    • Description
    • Parameters
    • Example
    • advance boolean
    • Playlists: Whether to auto-advance to next clip. Default: false
    • true, false
    • advance: true
    • auto_orient boolean
    • When true the player will request fullscreen when going from portrait to landscape; this does not guarantee fullscreen will happen. Many modern platforms have similar "best effort" rules like autoplay for this behavior.
    • true, false
    • auto_orient: true
    • autopause boolean
    • Whether a player should autopause when it is outside of the viewport. Default: false
    • true, false
    • autopause: true
    • autoplay boolean or bitflag
    • Whether the player should autoplay. Default: false, autoplay bit flags exist at flowplayer.autoplay. When using bitflags do not add quotation marks, ie it should read autoplay: flowplayer.autoplay.ON
    • true, false, flowplayer.autoplay.OFF, flowplayer.autoplay.ON, flowplayer.autoplay.AUDIO_REQUIRED, or use numeric values. See the autoplay options table
    • autoplay: flowplayer.autoplay.AUDIO_REQUIRED
    • controls string
    • Playlists: optional string with a <div> id which will contain the playlist queue controller. If left blank no UI is created.
    • string
    • controls: "#playlist_controls"
    • delay integer
    • Playlists: Number of seconds between clips. If larger than zero will show a countdown screen between clips. Default: 0
    • integer
    • delay: 2
    • description string
    • Descriptive text to show when hovering the player. Default: none
    • text string
    • description: "This is a video about videos, showing how to view videos"
    • disabled boolean
    • If true, seeking forward with mouse or keyboard is disabled. Default: false. Can be switched with the toggleDisable() API method
    • true, false
    • disabled: true
    • dvr boolean
    • Forces the dvr feature for live streams, overrides automatic detection; see also seconds_to_dvr.
    • true, false
    • dvr: true
    • string
    • Adds a custom logo to the player. See also the logo skinning docs.
    • url string
    • logo: "https://yourdomain.com/path/image.png"
    • logo_href string
    • An optional url which will redirect the user when clicking the logo. Default: none
    • text string
    • logo_href: "https://flowplayer.com/about"
    • loop boolean
    • Whether the player should loop the current video or playlist. Default: false
    • true, false
    • loop: true
    • live boolean
    • If true then the UI will show only live controls (mandatory for livestreams). Default: false
    • true, false
    • live: true
    • multiplay boolean
    • Whether the player should continue to play if another player on the current page also begins playback. Default: false
    • true, false
    • multiplay: true
    • muted boolean
    • Whether the player should start with sound turned off. Default: false
    • true, false
    • muted: true
    • plugins array platform embeds only
    • A special option to load additional plugins in platform embed codes generated from the platform UI. See the plugin configuration docs for details on the plugin configuration namespaces.
    • "airplay", "asel", "chromecast", "comscore", "cuepoints", "endscreen", "fas", "google-analytics", "keyboard", "qsel" , "speed", "subtitles", "thumbnails"
    • "plugins": ["airplay", "asel", "chromecast", "comscore", "cuepoints", "endscreen", "fas", "google-analytics", "keyboard", "qsel" , "speed", "subtitles", "thumbnails"]
    • poster string
    • Show a custom image instead of first frame of a video. Default: none
    • url string
    • poster: "https://myserver.mydomain.com/path/to/image.jpg"
    • preload string
    • Whether to preload the vido clip or its metadata. auto will attempt to load the complete video clip (careful: this might impose high bandwidth usage on page load even if the visitor does not start the video), Default: none.
    • none , auto , metadata
    • preload: "auto"
    • ratio string
    • Presets the player dimensions ratio in width:height format according to the dimensions of the video clip or live stream, either as calculated aspect ratio or using the real dimensions.
    • "width:height"
    • ratio: "16:9" ratio: "1280:720" ratio: "1.7:1"
    • rewind boolean
    • If set to true , the player will go back to the start after playback has finished and either show the poster image (if configured) or the first frame of the clip. Default: false
    • true, false
    • rewind: true
    • seconds_to_dvr integer
    • How many seconds of live content need to be buffered before dvr is enabled. Default: 60 seconds. Note: this is the length of bufferred content, not the time the stream is running. Do not use in combination with dvr: true|false as the dvr option will override any seconds setting.
    • x seconds
    • seconds_to_dvr: 30
    • seekable boolean
    • Enables or disables seeking back or forth in the timeline. Can be switched at runtime with the setOps() API method method. Default: true
    • true , false
    • seekable: false; (flowplayer.setOpts({seekable: true|false}))
    • shuffle boolean
    • Playlists: true will randomize the playback order of the playlist items.
    • true , false Default: false
    • shuffle: true
    • skip_controls boolean
    • Playlists: Display playlist skip controls in the player control bar.
    • true , false Default: false
    • skip_controsls: true
    • src string object array
    • The video source. Default: the source configured in the embed code.
    • see Video source
    • start_quality bitmask
    • Defines one of three possible start qualities for HLS sources, calculated from the levels available in the master manifest.
    • 1 (LOW), 2(MEDIUM), 4 (HIGH)
    • quality: 4 will start with the highest level.
    • start_time float
    • Defines a start time different than the beginning of the clip.
    • number with seconds and fractions of seconds. Note: this setting only has effect initially. Changing it with setOpts() is not possible.
    • start_time: 60 start_time: 10.5
    • title string
    • Title to show when hovering the player. Default: none
    • text string
    • title: "Video about videos"
    • token string
    • taken from the platform UI, this is used to ensure only valid domains use your assets
    • alphanumeric / special character string
    • token: "areallylongsrandomstringfromtheui"
    • ui integer
    • A bitmask disabling certain UI elements like fullscreen, mute and volume. Default: none. Only available for manual Javascript setups
    • See the UI configuration. Note: this is translated to an integer internally, so do not add quotes.
    • ui: flowplayer.ui.NO_VOLUME_CONTROL

Autoplay configuration

Autoplay can be configured in several ways either with the bitmask parameter or the numeric value representing it:

    • Option
    • Description
    • Value
    • flowplayer.autoplay.OFF
    • autoplay is disabled
    • 0
    • flowplayer.autoplay.ON
    • autoplay is enabled, if the browser does not allow autoplay with audio it will use muted autoplay
    • 1
    • flowplayer.autoplay.AUDIO_REQUIRED
    • the player will attempt autoplay, but if it can only proceed in a muted state, it will not attempt to play while muted and instead show the initial starting screen.
    • 2

Use autoplay with caution and keep in mind that most browsers do not allow autoplay with sound in many situations; we expect policies to become even more restrictive in the future. Autoplaying videos can be very annoying to users (especially when muted) and might waste bandwidth and battery energy. Check the current browser policies here:

User interface configuration

The following options are available for manual Javascript setups in the ui configuration object. You may also configure UI options for async platform embeds with the cloud player, but then you can only use the numeric values. To combine several options, add the values and configure the sum.

Example:

NO_HEADER | NO_TITLE | LOGO_RIGHT will have the numeric values 4096 | 256 | 8 and the resulting config value for "ui": will be 4360.

    • Option
    • Description
    • Numeric value
    • LOGO_ON_RIGHT
    • Show custom logo in right corner of the player
    • 8
    • NO_CONTROLS
    • Disable the complete control bar
    • 1024
    • NO_DESCRIPTION
    • Don't show clip description metadata (since v1.12.0)
    • 512
    • NO_DURATION
    • Disable display of clip duration on start screen
    • 2048
    • NO_FULLSCREEN
    • Hide fullscreen button
    • 1
    • NO_HEADER
    • Disable the header which holds the logo, as well as the share, cast and fullscreen buttons
    • 4096
    • NO_MUTE
    • Hide mute button
    • 4
    • NO_TITLE
    • Don't show clip title (since v1.12.0)
    • 256
    • NO_VOLUME_CONTROL
    • Hide volume control bar
    • 2
    • USE_DRAG_HANDLE
    • Add a round scrubbing handle to the timeline
    • 16
    • USE_PLAY_2
    • Use alternate play (outlined) button in the center of the player
    • 32
    • USE_PLAY_3
    • Use alternate play button (circled) in the center of the player
    • 64
    • USE_THIN_CONTROLBAR
    • Uses a thinner control bar that gets taller when the mouse is hovering the player
    • 128

Note the UI flags are configured without quotes and case-sensitive.

Using the "ui": object in an async cloud player embed will override all UI options selected in the hosted player configuration, so you need to recreate all desired options in the custom "ui": object configuration.

UI configuration sample code:

<!doctype html>
<html>
  <head>
  <title>ui flags</title>
  <link rel="stylesheet" href="//cdn.flowplayer.com/releases/native/3/stable/style/flowplayer.css">
  <script src="//cdn.flowplayer.com/releases/native/3/stable/flowplayer.min.js"></script>
  <!-- Optional plugins -->
  <script src="//cdn.flowplayer.com/releases/native/3/stable/plugins/hls.min.js"></script>
</head>
<body>
<div id="player_container"></div>
<script>
flowplayer("#player_container", {
  src: "https://yourserver.com/path/playlist.m3u8"
, token: "<yourtoken>"
, ui: flowplayer.ui.NO_VOLUME_CONTROL | flowplayer.ui.NO_MUTE | flowplayer.ui.NO_FULLSCREEN
});
</script>
</body>
</html>

Plugins

Flowplayer can be extended through plugins . All plugins are configured at the top level. Loading them depends on your embed method:

Loading plugins

  • If you use the manual Javascript setup, just add the plugin urls after the core player.
  • If you use the Flowplayer platform embeds, you can use the special plugins configuration object.

To configure, set a configuration object at the top level and include the desired options as explained in the linked plugin documentation:

Plugins configuration

Video source

The source ( root level "src": option) can be configured either as

  • String
    • If using an OVP hosted video it should be the GUID of the video (example: f576651c-4cc6-4664-84fa-bb3b35ef1aba)
    • If using a self-hosted video it should be the full URL to the video (example: https://edge.flowplayer.org/bauhaus.m3u8). MIME-type is guessed from the suffix. If you have non-standard extensions (like .mov - usage not recommended - or a query parameter for example, you must set the type property. Also make sure your server sends the correct MIME headers
  • Object with following properties
    • type - the MIME type (example video/mp4 or application/x-mpegurl)
    • src - the full url of the video (example: https://edge.flowplayer.org/bauhaus.m3u8)
  • Array of objects to have a fallback mime type for different browsers depending on browser support
    • Example: [{ "src": "https://edge.flowplayer.org/bauhaus.m3u8", "type": "application/x-mpegurl"}, { "src": "https://edge.flowplayer.org/bauhaus.mp4", "type": "video/mp4" }]

If you configure a source array with several source types like m3u8, mp4 and webm, they will be evaluated in the order they're given and the first source the browser supports will be played. This means that you should always list m3u8 first if you want to offer quality selection for example.

See also the technical requirements for self-hosted videos.

Token configuration

Configure the player with your unique token

When using manual JavaScript setups you need to configure the player with your unique token. The token can be created in your dashboard.

Create a player token

The token contains information about player ACL and subscription validity. When creating the token, you have the option to restrict the use of the token to up to two different domains. The token is also validated online on every play. If you cannot have the player calling home you can contact our sales for an OEM license.

The token has to be configured in the player with the token configuration value.

Initialize player

Create a <div> element in your HTML to act as the placeholder for the player:

<div id="player_container"></div>

And then finally call the flowplayer() initializer to kick of the player:

<script>
flowplayer('#player_container', {
  src: 'my_video.mp4',
  token: '<my_token>'
})
</script>
Results