MP4 Engine (Mp4Player)

The Mp4Player class manages native HTML5 video playback for progressive files (MP4, WebM, Ogg). It implements the standard PlayerControls interface to ensure consistency with the HLS and YouTube engines.

Basic Usage

import { Mp4Player } from "@playerkit/core";

const videoElement = document.querySelector("video");

const player = new Mp4Player({
  video: videoElement,
  src: "https://example.com/video.mp4",
});

player.play();

Options

Why use Mp4Player instead of vanilla HTMLVideoElement?

You might wonder why you need a class to wrap a native <video> tag. Using Mp4Player provides:

1. API Consistency: If your app switches between HLS and MP4, you can use the exact same subscribe and PlayerControls logic without writing if (isHls) branches.
2. Token Auth: It supports the same tokenFetcher and tokenRefresher background polling logic as the HLS engine.
3. Normalized State: It calculates bufferedPercentage and formats the state into a clean PlayerSnapshot.
4. Security: It hooks into the @playerkit/core SecurityManager to block DevTools and context menus if you enable enterprise protections.

Cleanup

// Detaches listeners and clears token refresh timers
player.destroy();