Skip to main content

mediaParserController()

Pass mediaParserController() to controller to steer the parseMedia() function.

Each mediaParserController can only be attached to 1 parseMedia() call.

import {mediaParserController, parseMedia} from '@remotion/media-parser';

const controller = mediaParserController();

parseMedia({
  src: 'https://www.w3schools.com/html/mov_bbb.mp4',
  controller,
});

// Pause
controller.pause();

// Resume
controller.resume();

// Abort
controller.abort();

API

This function returns an object that can be passed to parseMedia({controller}).

It has the following methods:

pause()

Pauses the download and parsing process.

resume()

Resumes the download and parsing process.

abort()

Aborts the download and parsing process.

seek(timeInSeconds: number)

Seeks to the best keyframe that comes before the time you specified.

getSeekingHints()

Returns a promise that resolves to the seeking hints.

addEventListener()

See events below.

removeEventListener()

See events below.

Events

You can attach event listeners to the object returned by mediaParserController().

import {mediaParserController, parseMedia} from '@remotion/media-parser';

const controller = mediaParserController();

const onPause = () => {
  console.log('Paused');
};

const onResume = () => {
  console.log('Resumed');
};

controller.addEventListener('pause', onPause);
controller.addEventListener('resume', onResume);

// Make sure to cleanup later:
controller.removeEventListener('pause', onPause);
controller.removeEventListener('resume', onResume);

It also emits the following events:

pause

Emitted when the download and parsing process is paused.

resume

Emitted when the download and parsing process is resumed.

See also