# 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.