Add Custom Configuration Options to the Player

Our video player (JW Player) contains many options for tweaking its layout and behavior. Most of these options can be set by managing your players in the Players tab of the dashboard. Our players do support additional, more advanced options too. They also support overriding of options inside your HTML page.

Example

An example option is mute, which can be set to true (the player is muted on startup) and false (the player has volume on startup). Here's a player that has the option set (check the small mute icon at the right side of the controlbar):

Here's the HTML code of this example:

<script type="text/javascript" src="http://content.bitsontherun.com/players/nPripu9l-ALJ3XQCI.js"></script>
<script type="text/javascript">
  botr_nPripu9l_ALJ3XQCI.addVariable("mute","true");
</script>

The additional line of JavaScript inserts the custom option into the player. As you can see, the principle is very simple:

• The name of the object is botr_VIDEOKEY_PLAYERKEY. The dash between the video key and the player key should be replaced with an underscore.
• The function for adding options is called addVariable().
• The first parameter of the function is the option's name, the second parameter is its value.

Since the videoplayer by default is the JW Player, all JW Player options are supported by Bits on the Run.

Plugins

The JW Player has the powerful ability to extend its functionality through plugins. Adding and configuring these plugins can also be done with options. The LongTail Plugins Library contains dozens of plugins. The setup page for every plugin describes the options needed to configure it.

Here is an example setup using the Flow plugin:

Here is the code with the options for this setup. Note the Flow plugin is automatically loaded off our CDN:

<script type="text/javascript" src="http://content.bitsontherun.com/players/JUsVgTHL-ALJ3XQCI.js"></script>
<script type="text/javascript">
  botr_JUsVgTHL_ALJ3XQCI.addVariable("plugins","flow");
</script>

It is possible to load multiple plugins, by simply comma-separating them:

botr_JUsVgTHL_B54rYOop.addVariable("plugins","flow,googima");

Built-in plugins

The following plugins are already built into the BOTR player setup, meaning you can simply enable them within the dashboard:

• sharing: Offer shortcuts for sharing video links and embed codes on blogs, Facebook and Twitter.
• captions: Show closed captions or multiple subtitle tracks with your videos.
• ltas: Make money by running ads from our AdSolution.
• gapro: Send your video events to Google Analytics.
• hd: Display a manual HD toggle with your videos (like YouTube/Vimeo).