@playkit-js/plugin-prevent-forward-seeks

playkit-js-prevent-forward-seeks

playkit-js-prevent-forward-seeks is a kaltura player plugin that prevent forward seek in these cases: if isActive is true and Metadata Exists => let the metadata decide if this feature is on; else take value from isActive

It relies on kaltura player core API for managing UI features.

playkit-plugin-prevent-forward-seeks is written in ECMAScript6 (*.js) and TypeScript (*.ts) (strongly typed superset of ES6), and transpiled in ECMAScript5 using Babel and the TypeScript compiler.

Webpack is used to build the distro bundle and serve the local development environment.

Features

This plugin prevents forward seek in these cases: if isActive is true and Metadata Exists => let the metadata decide if this feature is on; else take value from isActive

Getting started with development

# First, checkout the repository and install the required dependencies
git clone https://github.com/kaltura/playkit-js-prevent-forward-seeks.git

# Navigate to the repo dir
cd playkit-js-prevent-forward-seeks

# Run dev-server for demo page (recompiles on file-watch, and write to actual dist fs artifacts)
npm run dev

# Before submitting a PR - Run the pre commit command
npm run pre:commit

# this command will run:

# 1. types check
# 2. lint check
# 3. generate/update types
# 4. generate/update docs

The dev server will host files on port 800x. Once started, the demo can be found running at http://localhost:800x/.

Before submitting a PR, please see our contribution guidelines.

Linter (ESlint)

Run linter:

npm run lint:check

Run linter with auto-fix mode:

npm run lint:fix

Formatting Code

Run prettier to format code

npm run prettier:fix

Type Check

Run type-check to verify TypeScript types

npm run types:check

Automated tests (Mocha/Karma)

Run all tests at once:

npm test

Run unit tests in watch mode:

npm run test:watch

How to config

ui: {
  translations: {
    en: {
      'plugin-prevent-forward-seeks': {}
    }
  }
},
plugins: {
  pluginPreventForwardSeeks: {
    metaDataFieldName: 'BanSeek',
    isActive: true,
    showSeekModal: true
  }
}

Design

An overview of this project's design, can be found here.

API docs

API docs

Usage guide

usage guide

Demo

https://kaltura.github.io/playkit-plugin-prevent-forward-seeks/demo/index.html

External Demo

https://externaltests.dev.kaltura.com/player/sandBox/playerv7/prevent-forward-seeks/

Compatibility

playkit-plugin-prevent-forward-seeks is only compatible with browsers supporting MediaSource extensions (MSE) API with 'video/MP4' mime-type inputs.

playkit-plugin-prevent-forward-seeks.js is supported on:

• Chrome 39+ for Android
• Chrome 39+ for Desktop
• Firefox 41+ for Android
• Firefox 42+ for Desktop
• IE11 for Windows 8.1+
• Edge for Windows 10+
• Safari 8+ for MacOS 10.10+
• Safari for ipadOS 13+

License

playkit-plugin-prevent-forward-seeks.js is released under Apache 2.0 License