@holaspark.com/spark_player
v1.1.5
Published
An HTML5 and Flash video player with a common API and skin for both.
Downloads
1
Maintainers
Readme
Spark Player - Enhanced HTML5 Video Player
Spark Player is a web video player based on the popular video.js open source project world. It supports HTML5 and Flash video. It supports video playback on desktops and mobile devices. Spark Player integrates advanced features from holaspark.com
Features
- Commercial grade video player
- Integrated Spark analytics module
- Integrated bandwidth saver module
- All the features of the original video.js
- Custom branding (no watermark)
- HLS/HDS streaming
- HTML/CSS skin system
- Plugin support
- Multi platform (desktop and mobile devices)
- Player API
Quick start
To start using Spark Player, follow these steps:
Register for an account on holaspark.com
Add this script to your document's
<head>
, including your CustomerID as follows:
<script src="//player2.h-cdn.com/hola_player.js?customer=xxx"></script>
- Add a
<video>
tag on your page:
<video class="video-js vjs-default-skin" poster="//video.h-cdn.com/static/mp4/tears_of_steel_1080p_MP4.jpg" width="640" height="360" controls>
<source src="//video.h-cdn.com/static/mp4/tears_of_steel_360p_MP4.mp4" type="video/mp4">
</video>
- Initialize player:
<script>
window.hola_player();
</script>
- Done!
Self hosting
You can also Download prebuilt package and host it on your website.
You will also need to update the location of the swf files videojs.swf
and videojs-osmf.swf
.
Important: If you are using Spark or SparkCDN features you must retain the 'customer=' param of the url even after moving Spark Player to your servers.
<script src="//www.example.com/path/to/hola_player/hola_player.js?customer=xxx"></script>
Otherwise no param is required
<script src="//www.example.com/path/to/hola_player/hola_player.js"></script>
Also you MUST specify new swf locations explicitly. Copy our swf files to a location on your site and setup the paths as follows:
<script>
window.hola_player({
swf: "//www.example2.com/other/path/to/swf/videojs.swf",
osmf_swf: "//www.example3.com/another/path/videojs-osmf.swf"
});
</script>
Integrated video analytics
Spark Player comes integrated with the free hola video analytics module. To open your free account and have access to the analytics dashboard, check out holaspark. Spark analytics module provides the following information using the free dashboard:
- Start buffering times
- Total views
- Total minutes viewed
- Seek events
- Bandwidth saved using Bandwidth Saver
- And more..
The use of this feature requires a free hola account. To learn more about the hola analytics dashboard and to create your free account, visit www.holaspark.com.
Integrated bandwidth saver for progressive http
Spark Player comes integrated with the free hola bandwidth saver module. The bandwidth saver module uses progressive download methods to reduce buffer overhead while keeping the video loading time to a minimum and the player responsive. Bandwidth saver works with MP4/FLV streams.
Examples
Building your own copy of Spark Player
If you want to build your own copy of Spark Player and receive the latest updates follow these instructions:
First, fork the spark-mv/spark_player git repository. At the top of every github page, there is a Fork button. Click it, and the forking process will copy Spark Player into your own GitHub account.
Clone your fork of the repo into your code directory
git clone https://github.com/<your-username>/spark_player.git
Navigate to the newly cloned directory
cd spark_player
Assign the original repo to a remote called "upstream"
git remote add upstream https://github.com/spark-mv/spark_player.git
In the future, if you want to pull in updates to Spark Player that happened after you cloned the main repo, you can run:
git checkout master git pull upstream master
Install the required node.js modules using node package manager
npm install
A note to Windows developers: If you run npm commands, and you find that your command prompt colors have suddenly reversed, you can configure npm to set color to false to prevent this from happening.
npm config set color false
Note that this change takes effect when a new command prompt window is opened; the current window will not be affected.
Build a local copy of Spark Player
grunt
License
Spark Player is licensed under the ISC License. View the license file
Copyright 2017 Hola Networks ltd