Introduction

mp4.js is a library that convert mp4 to fmp4 at browser-side in time. it supports web player can play remote mp4 video file as stream.

Usually web player can play ordinary mp4 file by video,but it can't control loading media data or switch media resource smoothly.

If you use mp4.js than can load any media data as any indicated time,because it can analyze meta information and get binaray data without changing by service.

Usage

the package provides three version such as commonjs、esmodule、umd.

npm install mp4.js

<video id="player" autoplay controls width="1280" height="640"></video>

const MP4 = require('mp4.js')
const mp4 = MP4('./xgplayer-demo-720p.mp4')
const video = document.querySelector('#player')
function loadData (i = 0, time = video.currentTime) {
  if (timer) {
    clearTimeout(timer)
  }
  timer = setTimeout(() => {
    mp4.seek(time + i * 0.1).then(buffer => {
      if (buffer) {
        mse.updating = true
        mse.appendBuffer(buffer)
        mse.once('updateend', () => {
          mse.updating = false
        })
      }
    }, (error) => {
      if (i < 10) {
        timer = setTimeout(() => {
          this.loadData(i + 1)
        }, 2000)
      }
    })
  }, 50)
}
let mse
let timer
mp4.on('moovReady', function () {
  mse = new MP4.MSE()
  video.src = mse.url
  mse.on('sourceopen', () => {
    mse.appendBuffer(mp4.packMeta())
    mse.once('updateend', loadData)
  })
  video.addEventListener('timeupdate', function () {
    loadData(1)
  })
})

you can reffer more code in examples directory.

Examples

you can visit xgplayer website to experience it. if you just develop locally by reffering github examples

API

MP4 Class

let mp4 = new MP4(url,options,chunkSize)

parameter	description	optional
url	parameter requires remote address of mp4 file which supports CORS	false
options	parameter include withCredentials and videoOnly	true
chunkSize	parameter means data length per request which help minimize the network traffic	true

Method

mp4.getData(start,end,chunkSize)

parameter	description	optional
start	parameter requires initial position by byte	false
end	parameter requires end position by byte	false
chunkSize	parameter means data length number per request	true
return	Promise instance which outputs object incaluding xhr state	-

Usually you need't use it directly because MP4 provides advanced interface. Of course you can use it control more details.

mp4.getMetaInfo(start,end)

parameter	description	optional
start	parameter requires initial position by byte,default is zero	false
end	parameter requires end position by byte	true

this interface can get basic information about the mp4 file such as ftyp、moov、mdat. if succees it will trigger 'moovReady' event and the property mp4.meta is available.

mp4.packMeta()

parameter	description
return	Array.buffer

You know the moov box is indifferent between mp4 and fmp4,so we need repack the moov box. you just call the function once when MSE initialize because it includes ftyp and moov box.

mp4.seek(currentTime)

parameter	description	optional
currentTime	parameter require video.currentTime	false
return	Promise Instance which return Array.buffer	-

in most time, the interface is enough.

mp4.clear()

empty mse buffer cache and download cache.

Event

mp4.once('moovReady',handle)
mp4.once('error',handle)

MP4.MSE Class

let mse = new MP4.MSE(codecs)

parameter	description	optional
codecs	parameter is optional,default values is 'video/mp4; codecs="avc1.64001E, mp4a.40.5"'	true
return	MSE instance	-

MP4.MSE extends raw MSE API and Event.

Other

if you're interested in this package, xgplayer and xgplayer-mp4 is better way to learn that gives more usage and compatibility in products.

License

MIT