Fluid Player is a new free HTML5 video player. It is lightweight, easy to integrate and has advanced VAST* capabilities.
- Supports the VAST standard.
- Comes with its own design, which is easily customizable. Ability to use the browser default layout.
- Timeline Preview.
- Compatible with modern web browsers.
- Ability to have more than 1 player per page.
In order to set Fluid Player, three things are required:
- An HTML5
fluidVideo() function gets the video tag id as a first parameter, which is the only required one.
Integration Using Optional Parameters
Fluid Player can be customized by setting some optional parameters:
fluidPlayer(idVideoPlayer[, vastTag, options]);
Here is a description of the parameters which can be used when setting Fluid Player:
idVideoPlayer: The id of the html video tag, containing the main video to be played.
vastTag: The URL of the VAST Tag, which returns an XML describing the VAST ad to be displayed.
options: Various options for tweaking the appearance and behaviour of the player:
timelinePreview: Sets the timeline preview, visible when hovering over the progress bar. The provided
filecontains a description of the thumbnail images used for the preview. The
typesets the format of the file. Currently only the VTT format is supported. The timeline preview only works if the
defaultlayout is chosen (see below).
layout: Several options are available. The default layout is
default. It provides own skin to the player. Another option is
browser, meaning that the standard video player layout and behaviour, specific for each browser, is used. Also, a custom layout may be used: in this case there should be a folder with the given name inside the
/templatesfolder, containing a file
styles.css. Note: on iPhone devices the player always switches automatically to the
templateLocation: A custom folder where the template is located.
scriptsLocation: A custom folder where additional scripts are located.
skipButtonCaption(VAST only): The text, displayed on the Skip button. The text can contain the placeholder
[seconds]. The default value is
Skip ad in [seconds].
skipButtonClickCaption(VAST only): The text, displayed when the Skip button is available for clicking.
vastTimeout(VAST only): The number of milliseconds before the VAST Tag call timeouts. Default:
- Callback functions: can be used to execute custom code when some key events occur. Currently the following events are supported:
Fluid Player supports customization of its look. It is even possible to have several instances of the player, using different skins, on the same page.
The easiest way to create a custom skin is to make a copy of one of the existing templates, located in separate folders inside the
/templates/ folder. Then, it can be modified to implement the new skin.
When loading a template, the video wrapper element of the player (
id="fluid_video_wrapper_<VIDEO PLAYER ID>") will have the template name as an additional class name assigned, prefiexed with
fluid_player_layout_. This makes it possible for several templates to be used on different instances of Fluid Player on the same page.
For example, if a new skin, called
my_custom_skin is created, all CSS selectors should start with
The IAB Digital Video Ad Serving Template (VAST) specification is a universal XML schema for serving ads to digital video players, and describes expected video player behavior when executing VAST-formatted ad responses.
In short, VAST makes it possible for an ad provider to serve ads to various video players using a universal way of communication which all these players understand.
A thorough description of the overall idea behind VAST, as well as the full VAST specification, can be found here: VAST 4.0.
Fluid Player is licensed under the MIT License. View the License File.
A full list of changes and updates can be found in the project CHANGELOG.