Spec-Zone.ru › Web APIs

HTMLVideoElement

Базовая Широко доступна *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Реализуемый элементом <video>, интерфейс HTMLVideoElement предоставляет специальные свойства и методы для управления видеообъектами. Он также наследует свойства и методы HTMLMediaElement и HTMLElement.

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

EventTarget Node Element HTMLElement HTMLMediaElement HTMLVideoElement

Свойства экземпляра

Наследует свойства от своего родительского интерфейса, HTMLMediaElement, и HTMLElement.

HTMLVideoElement.disablePictureInPicture

Указывает, должен ли пользовательский агент предлагать пользователям режим "картинка в картинке" или нет.

HTMLVideoElement.height

Строка, отражающая атрибут HTML height, который задаёт высоту области отображения в пикселях CSS.

HTMLVideoElement.poster

Строка, отражающая атрибут HTML poster, который задаёт изображение для отображения во время отсутствия данных видео.

HTMLVideoElement.videoHeight Только чтение

Возвращает целое беззнаковое число, указывающее внутреннюю высоту ресурса в пикселях CSS, или 0, если медиа ещё недоступно.

HTMLVideoElement.videoWidth Только чтение

Возвращает целое беззнаковое число, указывающее внутреннюю ширину ресурса в пикселях CSS, или 0, если медиа ещё недоступно.

HTMLVideoElement.width

Строка, отражающая атрибут HTML width, который задаёт ширину области отображения в пикселях CSS.

Свойства, специфичные для Firefox

HTMLVideoElement.mozParsedFrames Нестандартный Только чтение Устаревший

Возвращает unsigned long со значением количества проанализированных кадров видео из медиа-ресурса.

HTMLVideoElement.mozDecodedFrames Нестандартный Только чтение Устаревший

Возвращает unsigned long со значением количества проанализированных кадров видео, которые были декодированы в изображения.

HTMLVideoElement.mozPresentedFrames Нестандартный Только чтение Устаревший

Возвращает unsigned long со значением количества декодированных кадров, которые были представлены в конвейер отрисовки для рисования.

HTMLVideoElement.mozPaintedFrames Нестандартный Только чтение Устаревший

Возвращает unsigned long со значением количества представленных кадров, которые были нарисованы на экране.

HTMLVideoElement.mozFrameDelay Нестандартный Только чтение Устаревший

Возвращает double со значением времени, на которое последний нарисованный кадр видео опоздал, в секундах.

HTMLVideoElement.mozHasAudio Нестандартный Только чтение Устаревший

Возвращает логическое значение, указывающее, есть ли звук, связанный с видео.

Методы экземпляра

Наследует методы от своего родительского интерфейса, HTMLMediaElement, и HTMLElement.

HTMLVideoElement.cancelVideoFrameCallback()

Отменяет ранее зарегистрированный обратный вызов кадра видео (см. requestVideoFrameCallback()).

HTMLVideoElement.getVideoPlaybackQuality()

Возвращает объект VideoPlaybackQuality, содержащий текущие метрики воспроизведения. Эта информация включает в себя такие вещи, как количество пропущенных или повреждённых кадров, а также общее количество кадров.

HTMLVideoElement.requestPictureInPicture()

Запрашивает у пользовательского агента переход в режим "картинка в картинке" для видео.

HTMLVideoElement.requestVideoFrameCallback()

Регистрирует функцию обратного вызова, которая выполняется при отправке нового кадра видео в композитор. Это позволяет разработчикам выполнять эффективные операции над каждым кадром видео.

События

Наследует события от своего родительского интерфейса, HTMLMediaElement, и HTMLElement.

Прислушивайтесь к этим событиям, используя addEventListener() или назначив обработчик событий свойству oneventname этого интерфейса.

enterpictureinpicture

Срабатывает, когда HTMLVideoElement успешно переходит в режим "картинка в картинке".

leavepictureinpicture

Срабатывает, когда HTMLVideoElement успешно покидает режим "картинка в картинке".

resize

Срабатывает, когда одно или оба свойства videoWidth и videoHeight только что были обновлены.

Спецификации

Спецификация
HTML
# htmlvideoelement

Совместимость с браузерами

Настольные Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
HTMLVideoElement 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37
cancelVideoFrameCallback 83 83 132 69 15.4 83 132 59 15.4 13.0 83
disablePictureInPicture 69 79
122Когда это свойство установлено в true, кнопка перекрытия для отключения функции «картинка в картинке» (PiP) скрыта, но пользователь всё ещё может включить PiP.
116–122["Это свойство не определено, но всё ещё оказывает влияние, если установлено в значение.", "Когда это свойство установлено в true, кнопка перекрытия для отключения функции «картинка в картинке» (PiP) скрыта, но пользователь всё ещё может включить PiP."]
56 13.1 105
122Когда это свойство установлено в true, кнопка перекрытия для отключения функции «картинка в картинке» (PiP) скрыта, но пользователь всё ещё может включить PiP.
116–122["Это свойство не определено, но всё ещё оказывает влияние, если установлено в значение.", "Когда это свойство установлено в true, кнопка перекрытия для отключения функции «картинка в картинке» (PiP) скрыта, но пользователь всё ещё может включить PiP."]
72 13.4 Нет
enterpictureinpicture_event 69 79 Нет 56 13.1 105 Нет 72 13.4 20.0 Нет
getVideoPlaybackQuality 80 12 42 67 8 80 42 57 12.2 13.0 80
height 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37
leavepictureinpicture_event 69 79 Нет 56 13.1 105 Нет 72 13.4 20.0 Нет
mozDecodedFrames Нет Нет 5 Нет Нет Нет 5 Нет Нет Нет Нет
mozFrameDelay Нет Нет 5 Нет Нет Нет 5 Нет Нет Нет Нет
mozHasAudio Нет Нет 15 Нет Нет Нет 15 Нет Нет Нет Нет
mozPaintedFrames Нет Нет 5 Нет Нет Нет 5 Нет Нет Нет Нет
mozParsedFrames Нет Нет 5 Нет Нет Нет 5 Нет Нет Нет Нет
mozPresentedFrames Нет Нет 5 Нет Нет Нет 5 Нет Нет Нет Нет
playsInline 75 79 Нет 62 10 75 Нет 54 10 11.0 75
poster 3 12 3.6 10.5 3.1 18 4 11 3 1.0 ≤37
requestPictureInPicture 69 79 Нет 56 13.1 105 Нет 72 13.4 20.0 Нет
requestVideoFrameCallback 83 83 132 69 15.4 83 132 59 15.4 13.0 83
resize_event 3 79
12–79Свойство обработчика событий onresize не поддерживается.
3.5 10.5 3.1 18 4 11 3 1.0 ≤37
videoHeight 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37
videoWidth 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37
width 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37

См. также

  • HTML-элемент, реализующий этот интерфейс: <video>.
  • Поддерживаемые форматы медиа

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API