@cycjimmy/jsmpeg-player

MPEG1 Video Player Based On JSMpeg

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@cycjimmy/jsmpeg-player
129136.0.56 months ago3 years agoMinified + gzip package size for @cycjimmy/jsmpeg-player in KB

Readme

JSMpeg Player(TS Player)
!workflows-badge-image !libraries dependency statuslibraries-status-imagelibraries-status-url !libraries sourceranklibraries-sourcerank-imagelibraries-sourcerank-url !Release daterelease-date-imagerelease-url !rolluprollup-imagerollup-url !semantic-releasesemantic-imagesemantic-url !npm licenselicense-imagedownload-url
  • jsmpeg-player has been renamed to @cycjimmy/jsmpeg-player for scoped NPM package.
  • JSMpeg player is based on jsmpeg.
  • The video must be compressed into the TS format of MPEG1 / MP2.
  • Apple device automatically plays without sound, you need to guide the user to click on the video in the lower right corner of the video icon to unlock the sound. (no similar problem in non-autoplay mode)
  • Demogithub-pages-url

How to use

Install

!NPM versionnpm-imagenpm-url !NPM bundle sizenpm-bundle-size-imagenpm-url !npm downloaddownload-imagedownload-url
$ npm install @cycjimmy/jsmpeg-player --save
# or
$ yarn add @cycjimmy/jsmpeg-player

Usage

import JSMpeg from '@cycjimmy/jsmpeg-player';
# OR
const JSMpeg = require('@cycjimmy/jsmpeg-player');

new JSMpeg.VideoElement(videoWrapper, videoUrl [, options] [, overlayOptions])

  • JSMpeg.VideoElement config:
videoWrapper: String | Element The wrapper of the video. The height and width of the wrapper are recommended to be initialized. videoUrl: String A URL to an MPEG .ts file options: Object support:
* `canvas`: [String | Element] The HTML canvas element to use for video rendering. If none is given, the renderer will create its own canvas element. Default `''`.
* `poster`: [String] URL to an image to use as the poster to show before the video plays. (Recommended to set it manually)
* `autoplay`: [Boolean] Whether to start playing immediately. Default `false`.
* `autoSetWrapperSize`: [Boolean] Whether to set the wrapper element size automatically when the video loaded. Default `false`.
* `loop`: [Boolean] Whether to loop the video (static files only). Default `false`.**[overwrite]**
* `control`: [Boolean] Whether the user can control. Default `true`.
* `decodeFirstFrame`: [Boolean] Whether to decode and display the first frame of the video. Default `true`.
* `picMode`: [Boolean] Picture mode (no playButton). Default `false`.
* `progressive`: [Boolean] whether to load data in chunks (static files only). Default `true`.
* `chunkSize` [Number] The chunk size in bytes to load at a time. Default `1024*1024` (1mb).
* `hooks`: [Object<Function>] The hook function
  * `play`: [Function] The hook function when the video play.
  * `pause`: [Function] The hook function when the video pause.
  * `stop`: [Function] The hook function when the video stop.
  * `load`: [Function] The hook function when the video established.
overlayOptions: Object More options can view the jsmpeg options
  • JSMpeg.VideoElement instance supports the following methods:
play(): Start playback pause(): Pause playback stop(): Stop playback and seek to the beginning destroy(): Stop playback and empty video wrapper

Use in browser

!jsdelivrjsdelivr-imagejsdelivr-url
<div id="videoWrapper"></div>
<script src="jsmpeg-player.umd.min.js"></script>
<script>
  var videoUrl = '../static/media/test_video.ts';
  new JSMpeg.VideoElement('#videoWrapper', videoUrl);
</script>

CDN

To use via a CDN include this in your HTML:
<script src="https://cdn.jsdelivr.net/npm/@cycjimmy/jsmpeg-player@6/dist/jsmpeg-player.umd.min.js"></script>

Encoding Video/Audio for jsmpeg by ffmpeg. E.g:

$ ffmpeg -i input.mp4 -f mpegts \
         -codec:v mpeg1video -s 640x360 -b:v 700k -r 25 -bf 0 \
         -codec:a mp2 -ar 44100 -ac 1 -b:a 64k \
         output.ts

  • options
-s: video size -b:v: video bit rate -r: frame rate -ar: sampling rate -ac: number of audio channels -b:a: audio bit rate