Связаться с намиПодключиться

SDK видеоплеера для IFrame

Статья создана
Обновлена 30 июля 2025 г.

Вы можете разместить видеоплеер с контентом из Cloud Video на HTML-странице с помощью SDK видеоплеера для IFrame.

Добавьте в код страницы iframe-контейнер:

<iframe
    frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=1"
></iframe>

Где https://runtime.video.cloud.yandex.net/player/... — ссылка на воспроизводимый контент, например https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y. Подробнее см. в разделах Получить код вставки или ссылку на видео и Получить код вставки или ссылку на трансляцию.

Код вставки содержит iframe-контейнер, в котором отображается плеер с указанным видео.

Вы также можете настроить размер видео и параметры запуска плеера.

Настроить размер видео

Чтобы указать размер видео, задайте в теге iframe параметры: height — высота и width — ширина.

Пример:

<iframe width="560" height="315" 
  frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/..."
></iframe>

Чтобы подстроить видео под ширину контейнера, измените код вставки так:

<div style="min-width: 100%">
  <div style="position: relative; padding-bottom: 56.25%; height: 0;">
    <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
        frameborder="0"
        scrolling="no"
        allowfullscreen
        allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
        src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=true"
    ></iframe>
  </div>
</div>

Настроить параметры запуска плеера

Вы можете настроить отображение плеера и воспроизведение видео с помощью специальных параметров.

К URL кода вставки после символа ? добавьте пары параметр=значение, разделяя их символом &:

https://runtime.video.cloud.yandex.net/player/...?param1=value1&...&paramN=valueN

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

Параметр:

Описание:

allow_muted

Автоматически запускать видео без звука при загрузке плеера:

  • false — автовоспроизведение без звука запрещено.
  • true — автовоспроизведение без звука разрешено.

Параметр allow_muted имеет приоритет перед autoplay. При использовании allow_muted=false автовоспроизведение произойдет только в случае, если оно возможно со звуком.

autoplay

Автоматически запускать видео при загрузке плеера:

  • 0 — видео не запускается автоматически.
  • 1 — видео запускается автоматически.

Значение по умолчанию — 0.

Чтобы автозапуск видео корректно работал во всех браузерах, используйте параметр autoplay=1 вместе с параметром mute=1.

t

Стартовое время (в секундах), с которого необходимо начинать воспроизведение.

Может принимать значения от 0 до длительности видео включительно, например t=30 (начать воспроизведение с 30-й секунды).

Если параметр не указан, обычное видео начнется с начала, а прямая трансляция — с текущего момента.

hidden

С помощью параметра можно скрыть элементы интерфейса плеера. По умолчанию отображаются все.

Список элементов интерфейса
  • * — все элементы интерфейса.
  • *,!<элемент-исключение> — все элементы интерфейса, кроме исключенного. Например, *,!play — скрыть все элементы интерфейса, кроме кнопки воспроизведения.
  • contextMenu — контекстное меню.
  • fullscreen — кнопка перевода в полноэкранный режим.
  • live — кнопка Вернуться в эфир.
  • mobileSeekButtons — кнопки перемотки в мобильном интерфейсе.
  • play — элемент интерфейса, в котором отображаются кнопки Воспроизвести, Пауза, Повторить. Отключает воспроизведение или паузу при нажатии на плеер.
  • playbackRate — скорость воспроизведения.
  • poster — постер.
  • preloader — индикатор загрузки.
  • settings — кнопка настроек.
  • startScreen — стартовый экран.
  • startScreenPlay — кнопка воспроизведения на стартовом экране.
  • subtitlesToggle — кнопка включения и выключения субтитров.
  • timeline — временная шкала. Отключает перемотку с клавиатуры или при нажатии на сенсорный экран.
  • timelinePreview — превью на временной шкале.
  • time — текущее время воспроизведения.
  • title — название видео.
  • sound — кнопка отключения звука.
  • volumeSlider — ползунок громкости.

Чтобы скрыть несколько элементов интерфейса, передайте строку со значениями через запятую, например hidden=startScreenPlay,play.

Примечание

Не рекомендуется использовать вместе autoplay=0 и hidden=*, с такими параметрами видео нельзя запустить.

lang

Язык, на котором будет отображаться интерфейс плеера.

Список языков
  • ru — русский.
  • en — английский.
  • be — белорусский.
  • id — индонезийский.
  • kk — казахский.
  • tr — турецкий.
  • tt — татарский.
  • uk — украинский.
  • uz — узбекский.

Если параметр не указан или передано неподдерживаемое значение, язык интерфейса плеера будет определяться на основании данных пользователя.

loop

Зацикливать воспроизведение видео:

  • false — видео не зациклено.
  • true — видео зациклено.

Значение по умолчанию — false.

mute

Выключать звук при загрузке плеера:

  • false — звук включен.
  • true — звук выключен.

Значение по умолчанию — false.

object_fit

Масштабировать обложку по размеру экрана при загрузке видео:

  • contain — сохранить исходные пропорции обложки, не обрезать.
  • cover — заполнить все доступное пространство обложкой, допустимо изменять пропорции или обрезать.

Значение по умолчанию — cover.

play_on_visible

Останавливать воспроизведение видео при уходе из зоны видимости и начинать воспроизведение при нахождении в ней. Параметр влияет на показ как видеоконтента, так и рекламных роликов. Он может принимать значения:

  • false — видео воспроизводится при уходе из зоны видимости.
  • true — видео не воспроизводится при уходе из зоны видимости.
  • доля видимости плеера, достаточная для воспроизведения; значение параметра указывается в виде десятичной дроби, разделитель — точка (.).

Значение по умолчанию — false. При значении true доля видимости равна 0.5.

Примечание

При play_on_visible=true параметр autoplay игнорируется. Параметр работает только в браузерах, в которых можно определить точную видимость плеера.

preload

Предварительно загружать видео:

  • false — видео предварительно не загружается.
  • true — видео предварительно загружается.

Значение по умолчанию — false.

При autoplay=1 параметр preload игнорируется.

volume

Громкость звука при загрузке плеера.

Может принимать значения от 0 до 1 включительно, например volume=0.5.

Значение параметра игнорируется, если mute=1.

background_color

Цвет фона плеера и виджетов.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

widget_text_color_primary

Цвет основного текста виджетов.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

widget_text_color_secondary

Цвет вторичного текста виджетов.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

widget_accent_color

Акцентный цвет текста виджетов.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

playlist_selected_item_background_color

Цвет фона активного элемента плейлиста.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

player_color

Цвет элементов интерфейса плеера: индикатора загрузки, временной шкалы и кнопки воспроизведения на стартовом экране при autoplay=0.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

widget_block_separator_color

Цвет разделителей блоков виджетов.

Поддерживаются цвета в формате HEX из трех и шести символов, а также стандартные для HTML названия цветов.

player_border_radius

Скругление углов блока плеера.

Значение по умолчанию — 3.

playlist_item_border_radius

Скругление углов элементов плейлиста.

Значение по умолчанию — 3.

widget_block_gap

Отступ плеера от блока плейлиста.

Значение по умолчанию — 0.

playlist_item_gap

Отступ между элементами плейлиста.

Значение по умолчанию — 10.

Пример

В примере видео будет запущено автоматически, но без звука:

<iframe
    frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y?autoplay=1&mute=true"
></iframe>
Предыдущая
Обзор
Следующая
iOS