@cycjimmy/jsmpeg-player
v6.1.2
Published
MPEG1 Video Player Based On JSMpeg
Downloads
13,227
Readme
JSMpeg Player(TS Player)
- 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)
- Demo
How to use
Install
$ 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 fileoptions
: [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. Defaultfalse
.autoSetWrapperSize
: [Boolean] Whether to set the wrapper element size automatically when the video loaded. Defaultfalse
.loop
: [Boolean] Whether to loop the video (static files only). Defaultfalse
.[overwrite]control
: [Boolean] Whether the user can control. Defaulttrue
.decodeFirstFrame
: [Boolean] Whether to decode and display the first frame of the video. Defaulttrue
.picMode
: [Boolean] Picture mode (no playButton). Defaultfalse
.progressive
: [Boolean] whether to load data in chunks (static files only). Defaulttrue
.chunkSize
[Number] The chunk size in bytes to load at a time. Default1024*1024
(1mb).hooks
: [Object] The hook functionplay
: [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 playbackpause()
: Pause playbackstop()
: Stop playback and seek to the beginningdestroy()
: Stop playback and empty video wrapper
JSMpeg.VideoElement.player
instance API can view the JSMpeg.Player API
Use in browser
<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