HTMLVideoElement
Базовая Широко доступна *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Реализуемый элементом <video>, интерфейс HTMLVideoElement предоставляет специальные свойства и методы для управления видеообъектами. Он также наследует свойства и методы HTMLMediaElement и HTMLElement.
Список поддерживаемых форматов медиа различается в разных браузерах. Вы должны либо предоставить видео в одном формате, поддерживаемом всеми соответствующими браузерами, либо предоставить несколько источников видео в достаточном количестве различных форматов, чтобы охватить все браузеры, которые вам необходимо поддержать.
Свойства экземпляра
Наследует свойства от своего родительского интерфейса, 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 | 7912–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