/h264-converter

Primary LanguageTypeScriptMIT LicenseMIT

H264 Converter

This library convert raw H.264 video streaming to fragmented mp4 for the Media Source Extensions of browser.

Install

npm install --save h264-converter

Usage

import VideoConverter from 'h264-converter';

// setup
const element = document.getElementById('videoTagId');
const converter = new VideoConverter(element, 30, 6);

// start streaming
fetch('/h264/raw/stream').then((res) => {
  if (res.body) {
    const reader = res.body.getReader();
    reader.read().then(function processResult(result) {
      function decode(value) {
        converter.appendRawData(value);
      }

      if (result.done) {
        decode([]);
        console.log('Video Stream is done.');
        return Promise.resolve();
      }
      decode(result.value);

      return reader.read().then(processResult);
    });
    converter.play();
    this.canceler = (message?: string) => {
      reader.cancel();
      console.log('Video Stream Request Canceled', message);
    };
  }
}).catch((err) => {
  console.error('Video Stream Request error', err);
});

API

class VideoConverter

constructor(videoElement: HTMLVideoElement, fps: number, fpf?: number)

  • videoElement: the video element for �display video streaming by Media Source Extensions API.
  • fps: frames per second of video stream.
  • fpf: frames per fragment of mp4.

appendRawData(data: ArrayLike<number>): void

append raw h264 data from streaming.

  • data: the received data from streaming.

play(): void

start to play the converted video.

pause(): void

pause the video.

reset(): void

reset inner state for changing stream.

debugging

setLogger(log: Logger, error?: Logger): void

set logger for output debugging log.

  • log: info logger, such as console.log.
  • error: error logger, such as console.error. default is same sa log value.