How Do I Integrate It?

Overview

The Dacast Player exposes a global window.dacast object. Use the dacast() function to initialize a player, then control it via the player instance.

JS file: https://prod-player.dacast.com/js/player.js

This page is the programmatic dacast() API. To get a contentId or an HTML snippet, see Embed codes. The UI embed loads prod-player.dacast.com; the REST embed snippet loads player.dacast.com. The contentId is the same. Iframe embeds are not documented here.

1. Initialization

const player = dacast(contentId, containerId [, options]);

PlayerOptions

Example:

<div id="my-player"></div>
<script src="https://prod-player.dacast.com/js/player.js"></script>
<script>
  const player = dacast("root_user_id-vod-VOD_ID", "my-player", {
    width: "640px",
    height: "360px"
  });
</script>

2. Player Instance API

After initialization, the player is also accessible globally:

const player = window.dacast.players["root_user_id-vod-VOD_ID"];

Note: The player object is available immediately, but methods are no-ops until the player is ready. Use onReady() to safely call methods after initialization.

Methods

ContentInfo Object

{
  contentId: string
  title: string
  description: string
  splashscreenUrl: string
  thumbnailUrl: string
}

Example:

const player = dacast("root_user_id-vod-VOD_ID", "my-player");

player.onReady(() => {
  player.seekTo(30);

  const info = player.getContentInfo();
  console.log(info.title, info.description);

  player.dispose();
});

TextTrack Object

{
  kind: string; // "subtitles" | "captions" | "chapters" | "metadata"
  label: string;
  language: string;
  mode: TextTrackMode;  // "showing" | "disabled" | "hidden";
  src?: string; // URL of the underlying track file
  type: string;
}

3. Player Events

Subscribe with player.on('event_name', callback) or player.onEventName(callback) - both return a Subscriber.

Unsubscribe with player.off('event_name', callback) or subscriber.unsubscribe().

interface Subscriber {
  unsubscribe: () => void
}

Event Methods