Видео

Чтобы добавить на экран видеоролик:

  • Используйте элемент с типом video.
  • Подключите в вашем приложении плеер. Подробнее читайте в разделе Видео страницы о ресурсах.

Примечание

Для работы видео необходимо указать либо video_sources, либо player_settings_payload. Если оба параметра отсутствуют, будет сгенерирована ошибка валидации.

Посмотреть интерактивный пример

Свойства элемента video

В примере выше:

  • video_sources — массив из вариантов одного и того же видеоролика с разными MIME-типами. Плеер выбирает из списка тот источник, который может воспроизвести на данной платформе. Параметр является опциональным, но должен быть указан либо он, либо player_settings_payload.
  • player_settings_payload — дополнительные настройки для внешнего видеоплеера. Используется для интеграции с кастомными плеерами. Параметр является опциональным, но должен быть указан либо он, либо video_sources. Поддерживает выражения; при изменении значения во время работы приложения плеер обновляет настройки воспроизведения.
  • repeatable — определяет, будет ли видео автоматически повторяться после завершения воспроизведения.
  • autostart — определяет, будет ли воспроизведение запущено автоматически.
  • muted — определяет, будет ли отключен звук при воспроизведении видео.
  • preview — строка, которая содержит превью — изображение в кодировке Base64, которое будет отображаться до момента, когда плеер закончит рендеринг первого кадра видеоролика.
  • elapsed_time_variable — содержит имя переменной, в которой будет храниться текущая позиция воспроизведения видео в миллисекундах. При изменении значения переменной извне плеер установит позицию воспроизведения в соответствии со значением переменной.
  • playback_speed — скорость воспроизведения видео. Значение 1.0 соответствует нормальной скорости, значения больше 1.0 — ускорению, меньше 1.0 — замедлению. Поддерживает использование выражений для динамического изменения скорости.
  • height — высота контейнера видеоэлемента.
  • width — ширина контейнера видеоэлемента.
  • preload_required — устаревшее свойство. Будет удалено в следующей мажорной версии DivKit.

Подробное описание свойств элемента video приведено в справочнике элементов.

Управление воспроизведением

Элемент video содержит только свойства плеера, все элементы контроля за воспроизведением видео реализуются с помощью вызова соответствующих действий div-action.

Примечание

На платформе iOS при размещении нескольких видео внутри компонента pager библиотека автоматически управляет их воспроизведением: при запуске нового видео все остальные воспроизводящиеся видео в том же pager автоматически ставятся на паузу. Это гарантирует, что в один момент времени воспроизводится только одно видео, и предотвращает остановку видео при скролле страницы.

Пример кода, реализующего запуск видеоролика
{
  "type": "image",
  "scale": "fit",
  "image_url": "https://sample_host/image.png",
  "actions": [
    {
      "log_id": "play",
      "url": "div-action://video?id=new_video&action=start"
    }
  ]
}

В этом примере при нажатии на изображение запустится воспроизведение видео. Параметры вызова действия div-action:

  • path: video — указывает, что действие производится над элементом типа video.

  • id: new_video — идентификатор видеоэлемента, над которым будет произведено действие.

  • action: start — действие, которое будет произведено над видео. В данном случае — запуск воспроизведения. Поддерживаемые значения параметра action для видеоэлемента:

    • start
    • pause

Как подключить видеоплеер

Чтобы элемент video воспроизводил ролики, приложение подключает видеоплеер: на Android это делается явно, на остальных платформах используется стандартный плеер. Подключение стандартного и собственного плеера описано на странице Ресурсы: шрифты, изображения и видео.

Узнать больше

Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: https://t.me/divkit_community_ru.

Репозиторий DivKit

Предыдущая
Следующая