/flowplayer-hlsjs

Flowplayer HLS.js plugin

Primary LanguageJavaScriptMIT LicenseMIT

Flowplayer hlsjs plugin

This plugin provides the hlsjs engine for playback of HLS streams in browsers which do not support playback of HLS in a VIDEO tag, and without the need for Flash.

The plugin relies on the hls.js client, courtesy of dailymotion.

Usage

See: https://flowplayer.org/docs/plugins.html#hlsjs

CommonJS

The plugin can be used in a browserify and/or webpack environment with a commonjs loader:

var flowplayer = require('flowplayer');
var engine = require('flowplayer-hlsjs');
engine(flowplayer);

flowplayer('#container', {
  clip: {
    sources: [{
      type: 'application/x-mpegurl',
      src: '//stream.flowplayer.org/bauhaus.m3u8'
    }]
  }
});

Demo

A fully documented demo can be found here.

Features

  • packs a compatibility tested version - current: v0.6.2-7 - of hls.js
  • by default the engine is only loaded if the browser supports MediaSource extensions reliably for playback
  • configurable manual HLS quality selection

Debugging

A quick way to find out whether there's a problem with the actual plugin component is to run your stream in the hls.js demo player.

For fine grained debugging load the unminified components and turn hlsjs debugging on:

<script src="//releases.flowplayer.org/6.0.5/flowplayer.min.js"></script>
<!-- test a hls.js release -->
<script src="//cdn.jsdelivr.net/hls.js/0.6.2-7/hls.min.js"></script>
<!-- separate hlsjs plugin component -->
<script src="//releases.flowplayer.org/hlsjs/flowplayer.hlsjs.js"></script>

<script>
// turn on hlsjs debugging
flowplayer.conf.hlsjs = {
  debug: true
};
</script>

Building the plugin

Build requirement:

cd flowplayer-hlsjs
make deps
make