Видео
Чтобы добавить на экран видеоролик:
- Используйте элемент с типом
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для видеоэлемента:startpause
Как подключить видеоплеер
Чтобы элемент video воспроизводил ролики, приложение подключает видеоплеер: на Android это делается явно, на остальных платформах используется стандартный плеер. Подключение стандартного и собственного плеера описано на странице Ресурсы: шрифты, изображения и видео.
Узнать больше
Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: https://t.me/divkit_community_ru.