- Notifications
You must be signed in to change notification settings - Fork1
A reference client implementation for the playback of MPEG DASH via Javascript and compliant browsers.
License
DiceTechnology/dash.js
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Build status (CircleCI):
If you are migrating from dash.js v3.x to dash.js v4.x please read the migration document foundhere.
A reference client implementation for the playback of MPEG DASH via JavaScript andcompliant browsers. Learn more about DASH IF Reference Client on ourwiki.
If your intent is to use the player code without contributing back to this project, then use the MASTER branch which holds the approved and stable public releases.
If your goal is to improve or extend the code and contribute back to this project, then you should make your changes in, and submit a pull request against, the DEVELOPMENT branch. Read ourCONTRIBUTION.md file for a walk-through of the contribution process.
All new work should be in the development branch. Master is now reserved for tagged builds.
All these reference builds and minified files are available under both http and https.
Multipledash.js samples covering a wide set of common use cases.
The releasedpre-built reference players if you want direct access without writing any Javascript.
Thenightly build of the /dev branch reference player, is pre-release but contains the latest fixes. It is a good place to start if you are debugging playback problems.
The latest minified files have been hosted on a global CDN and are free to use in production:
In addition, all the releases are available under the following urls. Replace "vx.x.x" with the release version, for instance "v3.1.0".
FullAPI Documentation is available describing all public methods, interfaces, properties, and events.
For help, join ourSlack channel, ouremail list and read ourwiki.
Detailed information on specific topics can be found in our tutorials:
- Low latency streaming
- UTCTiming Clock synchronization
- Digital Rights Management (DRM) and license acquisition
- Buffer and scheduling logic
The standard setup method uses javascript to initialize and provide video details to dash.js.MediaPlayerFactory provides an alternative declarative setup syntax.
Create a video element somewhere in your html. For our purposes, make sure the controls attribute is present.
<videoid="videoPlayer"controls></video>
Add dash.all.min.js to the end of the body.
<body> ...<scriptsrc="yourPathToDash/dash.all.min.js"></script></body>
Now comes the good stuff. We need to create a MediaPlayer and initialize it.
varurl="https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd";varplayer=dashjs.MediaPlayer().create();player.initialize(document.querySelector("#videoPlayer"),url,true);
When it is all done, it should look similar to this:
<!doctype html><html><head><title>Dash.js Rocks</title><style>video {width:640px;height:360px; }</style></head><body><div><videoid="videoPlayer"controls></video></div><scriptsrc="yourPathToDash/dash.all.min.js"></script><script>(function(){varurl="https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd";varplayer=dashjs.MediaPlayer().create();player.initialize(document.querySelector("#videoPlayer"),url,true);})();</script></body></html>
We publish dash.js tonpm. Examples of how to use dash.js in different modulebundlers can be found in thesamples/modules directory.
An alternative way to build a Dash.js player in your web page is to use the MediaPlayerFactory. The MediaPlayerFactory will automatically instantiate and initialize the MediaPlayer module on appropriately tagged video elements.
Create a video element somewhere in your html and provide the path to yourmpd file as src. Also ensure that your video element has thedata-dashjs-player attribute on it.
<videodata-dashjs-playerautoplaysrc="https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd"controls></video>
Add dash.all.min.js to the end of the body.
<body> ...<scriptsrc="yourPathToDash/dash.all.min.js"></script></body>
When it is all done, it should look similar to this:
<!doctype html><html><head><title>Dash.js Rocks</title><style>video {width:640px;height:360px; }</style></head><body><div><videodata-dashjs-playerautoplaysrc="https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd"controls></video></div><scriptsrc="yourPathToDash/dash.all.min.js"></script></body></html>
- Install Core Dependencies
- Checkout project repository (default branch: development)
git clone https://github.com/Dash-Industry-Forum/dash.js.git
- Install dependencies
npm install
- Build, watch file changes and launch samples page, which has links that point to reference player and to other examples (basic examples, captioning, ads, live, etc).
npm run start
- Build distribution files (minification included)
npm run build
- Build and watch distribution files
npm run dev
- Run linter on source files (linter is also applied when building files)
npm run lint
- Run unit tests
npm run test
- Generate API jsdoc
npm run doc
- In case the build process is failing make sure to use an up-to-date node.js version. The build process was successfully tested with node.js version 14.16.1.
dash.js is released underBSD license
About
A reference client implementation for the playback of MPEG DASH via Javascript and compliant browsers.
Resources
License
Stars
Watchers
Forks
Packages0
Languages
- JavaScript99.4%
- Other0.6%