Havik Player

Web, iOS and Android

The same streams, the same events and the same error codes on every platform. Web is available today, iOS is in private preview and Android is in development.

Native SDKs

Playback analytics included

Join time, rebuffering, quality switches and session attribution are measured in the player and reported to Oddin. CMCD tagging and QoE beacons are on by default.

Widevine and FairPlay DRM

The SDK picks the key system, signs the license request and refreshes the license so long sessions do not expire. Same on web and on native.

DRM guide

About five seconds glass-to-glass

LL-HLS playback runs roughly 2 s behind the live edge. Catch-up after a stall, a drift ceiling and a stable start are part of the defaults.

Starts when the match starts

Arm the player on an upcoming match and it attaches as soon as the stream goes live. It uses a push channel, with polling as a fallback, so nobody has to schedule anything.

Controls you can skin

The control bar is driven by CSS variables. Pass a theme object, or override the --havik-* variables in your own stylesheet.

Three integration modes

A copy-paste iframe with no build step, a managed player that owns your <video> element, or resolve-only mode if you already have a player stack. Moving between them does not mean changing vendor.

Typed events and stats

Player state, playback stats, quality/audio/text tracks and typed errors, over the SDK or the iframe postMessage bridge.

How it works

1Onboard once

You get a publishable api-key, and your domains and apps go on its allow-list.

2Embed the player

An iframe, the JS SDK, or a native SDK. Pass a match URN and a key.

3We deliver the stream

DRM-protected low-latency HLS from a global CDN, with go-live pickup.

4You see the quality

QoE measured in the player: join time, rebuffers, quality switches.

Play a match in your page

Iframe (no build step)SDK embed (recommended)Managed playerBring your own player

html

<!-- Quickest possible integration. See the guide for production hardening. -->
<iframe
  src="https://player-dev.oddin-video.gg/embed/?baseUrl=https%3A%2F%2Ffeed-dev.oddin-video.gg&matchUrn=od%3Amatch%3A1234&apiKey=pk_test_your_key"
  allow="autoplay; encrypted-media; picture-in-picture; fullscreen"
  allowfullscreen
  referrerpolicy="no-referrer"
  style="border: 0; width: 100%; aspect-ratio: 16 / 9"
></iframe>

import { mountEmbed } from '@oddin-gg/havik-player';

const embed = mountEmbed({
  container: document.querySelector('#player')!,
  src: 'https://player-dev.oddin-video.gg/embed/',
  baseUrl: 'https://feed-dev.oddin-video.gg',
  matchUrn: 'od:match:1234',
  apiKey: 'pk_test_your_key', // dev only — see the embed guide
  onEvent: (msg) => console.log(msg.type),
});

embed.play();

import { createPlayer } from '@oddin-gg/havik-player';

const player = await createPlayer({
  video: document.querySelector('video')!,
  baseUrl: 'https://feed-dev.oddin-video.gg',
  matchUrn: 'od:match:1234',
  credential: { apiKey: 'pk_test_your_key' },
  muted: true,
  waitForLive: true,
});

import { resolveStream, licenseRequestHeaders } from '@oddin-gg/havik-player';

const cred = { apiKey: 'pk_test_your_key' };

const stream = await resolveStream({
  baseUrl: 'https://feed-dev.oddin-video.gg',
  matchUrn: 'od:match:1234',
  credential: cred,
  waitForLive: true,
});

// stream = { manifestUrl, drm: { widevine: { licenseUrl } }, … } — feed it to
// YOUR player and attach licenseRequestHeaders(stream, cred) on license calls.
// Full hls.js wiring: see the Bring-your-own-player guide.

Your api-key only works from origins Oddin has allow-listed, so onboard your domains before the first play. Every stream needs a match URN and a publishable api-key, and both come with onboarding.

Native apps, same streams

The iOS SDK plays FairPlay-protected LL-HLS through AVPlayer and is in private preview, on device today. The Android SDK, built on Media3 and Widevine, is in development. Both use the same resolve API, the same events and the same errors as the web SDK.

Havik Player DemoiOS · App StoreComing soon

Havik Player DemoAndroid · Google PlayComing soon

Want early access? havik-support@oddin.gg

Havik PlayerPlayer SDKs for live esports streams