@mycujoo/player-mls

MyCujoo MLS player

Based on video.js project

Dependencies

This project's advanced features and some of the core features will require this packages to be used in your project:

react
react-dom
immer
@emotion/react
lodash
@silvermine/videojs-chromecast

Usage

To use MyCujoo MLS Player in a React project all you need is to install this package:

yarn add @mycujoo/player-mls

And then use it in your code:

If you want to use advanced features of the player you will have to use the contexts provided by this project. In which case the minimal setup will look like this:

import Player, { PlayerStateContextProvider, AnnotationsContextProvider } from '@mycujoo/player-mls'

....
// render method of your component
  <PlayerStateContextProvider>
    <AnnotationsContextProvider>
      <Player source="path-to-m3u8-file" />
    </AnnotationsContextProvider>
  </PlayerStateContextProvider>

API

Prop	Type	Description
source	string	Path to m3u8 or mp4 video source, required
autoplay	bool	html5 video tag autoplay attribute
qualitySelector	bool	Determines if quality selector should be used or not
scoreboard	bool	Determines if scoreboard should be used or not, reuires scoreboardConfig prop to work
debug	bool	Toggles debug mode, if it is on video.js and youbora debug levels will be set to maximum output
youboraOptions	object	If you want to send stats to youbora, see youboraOptions interface for more info
googimaTag	string	If specified enables Google IMA integration
scoreboardConfig	object	Required to show scoreboard component, see scoreboardConfig interface for more info
midrolls	object	If specified enables midroll ads, see Midroll type for more info
onError	function	Is triggered when video.js throws an error, see vjs errors documentation for more info
onPlayerActive	function	Is triggered when video is playing every 5 seconds to report healthy playback
onVideoPlay	function	Is triggered on html5 video tag play event
onVideoPause	function	Is triggered on html5 video tag pause event
onSeekStart	function	Is triggered on html5 video tag seeking event
onSeekEnd	function	Is triggered on html5 video tag seeked event
onBufferStart	function	Is triggered on html5 video tag waiting event
onBufferEnd	function	Is triggered on html5 video tag playing event
onAdsManager	function	Is triggered on when the ad manager is initialized; google ima AdManager is the only parameter
onAdsBreakStart	function	Is triggered on AdsManager loaded event
onAdSkip	function	Is triggered on AdsManager skip event
onAdStart	function	Is triggered on AdsManager start event; AdEvent is the only parameter
onAdComplete	function	Is triggered on AdsManager complete event
onAdsBreakComplete	function	Is triggered on AdsManager skip or complete events
onVideoStart	function	Is triggered on first occurence of html5 video tag play event
onVideoEnd	function	Is triggered on html5 video tag end event
onFullscreenChange	function	Is triggered when fullscreen status changes; should have a boolean parameter for the status

Development

To set up development environment for this project you will need to link player package inside you project, but also link all peer dependencies from you project inside player.

So the steps are following:

1. Run yarn link inside @mycujoo/player-mls repository
2. Go to the project root and run yarn link @mycujoo/player-mls
3. Go to each of the following dependency packages inside the project using the MLS player node_modules and run yarn link
4. Go to @mycujoo/player-mls repository again and run yarn link immer react react-dom @emotion/react

To speed up the build, make sure that terser and visualizer are disabled in rollupConfig, development config would be created in the future.

To deploy new version to npm: Make sure you updated version in package.json, then create new tag with version format and push it to the repo:

git tag v1.0.50 -am 'version 50 message'
git push origin v1.0.50

This will trigger a build and automatically publish the updated version from package.json. Alternatively the package can be published by running npm publish.

Tests

Run yarn test to run tests. Right now tests are WIP.