Runtime & API

Runtime Contract

• Execution environment: modern browsers on desktop and mobile (Chrome, Firefox, Safari, Edge).
• Required runtime capabilities vary by decode strategy: WASM (broadest support), MSE, WebCodecs (requires HTTPS/localhost), WASM SIMD, and multi-threaded.
• Autoplay requires muted state — call cancelMute() after a user interaction to enable audio.
• Fullscreen behavior depends on browser policies; use web fullscreen mode as fallback on mobile.
• WebCodecs H.265 decoding requires HTTPS or localhost context.
• Microphone access (for voice communication) requires HTTPS or localhost.

Quick Start

<script src="jessibuca-pro.js"></script>
<div id="container" style="width:640px;height:360px;"></div>

<script>
  var player = new JessibucaPro({
    container: document.getElementById('container'),
    videoBuffer: 0.2,
    decoder: 'decoder-pro.js',
    useMSE: true,
    loadingText: 'Loading',
    showBandwidth: true,
    operateBtns: {
      fullscreen: true,
      screenshot: true,
      play: true,
      audio: true,
    },
  });

  player.play('your-stream-url');

  player.on('play', () => console.log('Playing'));
  player.on('error', (type, msg) => console.error(type, msg));
</script>

Core Constructor Options

Core Methods

Events

Listen to events via: player.on(JessibucaPro.EVENTS.error, (type, msg) => { ... })

Error Types

The error event provides an error type constant from JessibucaPro.ERROR:

• playError — play called with empty URL
• fetchError — HTTP request failed
• websocketError — WebSocket failed
• webcodecsH265NotSupport — WebCodecs H.265 not supported
• webcodecsDecodeError — WebCodecs decode failure
• mediaSourceH265NotSupport — MSE H.265 not supported
• mediaSourceFull — MSE buffer full
• wasmDecodeError — WASM decode failure
• hlsError — HLS error
• webrtcError — WebRTC error
• webglAlignmentError — WebGL alignment error
• videoElementPlayingFailed — Video element play failed