Плеер deep.
На вашем сайте.

Для подключения получите у deep идентификатор partner и согласуйте адреса сайтов, на которых будет размещён плеер. Идентификатор подключения используется в публичной ссылке на iframe.

1. Укажите ваш сайт

   Адрес включает схему, домен и порт. Например, https://site.example. Версии с www и без www согласуются отдельно.

2. Выберите произведение

   Замените title-slug на slug из ссылки deep, а my-site — на свой идентификатор подключения.

3. Добавьте iframe

   Укажите сезон, серию и озвучку. Если выбор озвучки не нужен, уберите параметр audio.

<iframe
  id="deep-player"
  src="https://embed.deep-ent.ru/title-slug?partner=my-site&amp;season=1&amp;episode=1&amp;audio=studio-slug&amp;parentOrigin=https%3A%2F%2Fsite.example"
  title="Плеер deep"
  allow="autoplay; fullscreen; picture-in-picture; encrypted-media"
  allowfullscreen
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
  style="width:100%;aspect-ratio:16/9;border:0"
></iframe>

Все ID, slug и домены в примерах вымышленные. Замените их значениями своего подключения.

Базовый адрес: https://embed.deep-ent.ru/title-slug. Дополнительные параметры передаются в строке запроса.

Параметр parentOrigin можно не передавать: плеер определит сайт по данным браузера или Referer. SDK также подставляет его автоматически. Если сайт скрывает сведения о родителе, передайте точный адрес через URLSearchParams или используйте SDK. Маска домена в этом параметре не подходит.

Размер iframe задаёт ваш сайт. Сохраняйте соотношение 16:9 и достаточную высоту для элементов управления. Для целочисленных параметров верхняя граница — 2 147 483 647.

Обычный iframe работает самостоятельно. Подключите SDK, если нужно управлять видео или получать события на своей странице. Создавайте один экземпляр DeepPlayer на iframe.

<!-- Добавьте после iframe -->
<script src="https://embed.deep-ent.ru/sdk/v1.js"></script>
<script>
  const player = new DeepPlayer(
    document.getElementById('deep-player'),
    { timeout: 15000 }
  );

  player.on('statechange', (state) => {
    // ready означает, что видео готово к управлению.
    console.log(state.status);
  });

  // Подключение канала API, а не начало воспроизведения.
  player.ready
    .then(() => player.getState())
    .then((state) => console.log(state))
    .catch((error) => console.error(error.code));
</script>

Команды управления и getState() возвращают Promise. Обрабатывайте ошибки через catch; их машинный код доступен в error.code.

// Вызывайте из обработчика действия пользователя.
async function selectEpisode(season, episode) {
  try {
    await player.setEpisode(season, episode);
    // Загрузка завершится событием episodechange/statechange.
  } catch (error) {
    console.error(error.code);
  }
}

async function playFrom(seconds) {
  try {
    await player.seek(seconds);
    await player.play();
  } catch (error) {
    // Браузер может потребовать клик внутри самого iframe.
    console.error(error.code);
  }
}

Подписывайтесь через player.on(event, handler). События воспроизведения содержат публичное состояние текущей серии.

{
  "title": "title-slug",
  "season": 1,
  "episode": 2,
  "episodeId": "00000000-0000-4000-8000-000000000001",
  "audio": "studio-slug",
  "positionSec": 120.4,
  "durationSec": 1440,
  "paused": false,
  "muted": false,
  "volume": 0.8,
  "status": "ready"
}

Статусы: loading — загрузка, ready — готов к просмотру, locked — нужен доступ, error — ошибка. Пока новая серия загружается, её episodeId может быть null, а позиция и длительность равны нулю.

let lastReported = 0;
function onProgress(state) {
  if (state.status !== 'ready' || !state.episodeId) return;
  if (Date.now() - lastReported < 10000) return;
  lastReported = Date.now();

  // Передайте эти поля в систему прогресса вашего сайта.
  console.log({
    title: state.title,
    season: state.season,
    episode: state.episode,
    audio: state.audio,
    positionSec: state.positionSec,
    durationSec: state.durationSec
  });
}

player.on('timeupdate', onProgress);
player.on('pause', (state) => console.log('Пауза', state));
player.on('ended', (state) => console.log('Серия завершена', state));

// При удалении плеера со страницы (например, в SPA):
function disposePlayer() {
  player.off('timeupdate', onProgress);
  player.destroy();
  document.getElementById('deep-player')?.remove();
}

Решение о сохранении прогресса на вашем сайте принимает ваша интеграция. Для продолжения после перезагрузки передайте сохранённую позицию в start или вызовите seek() после готовности видео.

События браузера помогают интерфейсу и аналитике, но не подтверждают оплату или право доступа к видео. Состояние плеера не содержит данные аккаунта или ссылки на видеофайлы.

Для группы поддоменов можно согласовать правило https://*.example.com. Оно включает все уровни поддоменов; сам https://example.com подключается отдельно.

Форму входа и покупку обрабатывает deep. На стороне вашего сайта достаточно оставить стандартные элементы плеера доступными и при необходимости слушать authchange и accesschange.

Вход сохраняется при обновлении страницы в той же вкладке на время сессии плеера — до 6 часов. При закрытии вкладки, истечении сессии или запрете хранения данных браузером потребуется повторное подключение. Доступ к конкретной серии всегда проверяет deep. Наличие идентификатора партнёра не открывает платное видео.