HTMLMediaElement — веб-API | MDN

Интерфейс HTMLMediaElement добавляет к HTMLElement свойства и методы, необходимые для поддержки основных возможностей, связанных с мультимедиа, которые являются общими для аудио и видео.

Элементы HTMLVideoElement и HTMLAudioElement наследуют этот интерфейс.

Цель события Узел Элемент HTMLЭлемент HTMLMediaElement

Этот интерфейс также наследует свойства своих предков HTMLElement , Element , Node и EventTarget .

HTMLMediaElement.audioTracks

AudioTrackList , в котором перечислены объекты AudioTrack , содержащиеся в элементе.

HTMLMediaElement.autoplay

Логическое значение, отражающее

autoplay HTML-атрибут, указывающий, должно ли воспроизведение автоматически начинаться, как только становится доступным достаточное количество медиафайлов для непрерывного воспроизведения.

Примечание: Автоматическое воспроизведение звука, когда пользователь не ожидает или не желает этого, плохо работает с пользователем, и его следует избегать в большинстве случаев, хотя есть и исключения. Дополнительную информацию см. в руководстве по автовоспроизведению для мультимедийных и веб-аудио API. Имейте в виду, что браузеры могут игнорировать запросы автозапуска, поэтому вы должны убедиться, что ваш код не зависит от работы автозапуска.

HTMLMediaElement.buffered Только чтение

Возвращает объект TimeRanges , указывающий диапазоны источника мультимедиа, буферизованного браузером (если есть) в момент обращения к свойству buffered .

HTMLMediaElement.controls

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

HTMLMediaElement.controlsList Только чтение

Возвращает DOMTokenList , который помогает пользовательскому агенту выбирать, какие элементы управления отображать в медиа-элементе всякий раз, когда пользовательский агент показывает свой собственный набор элементов управления. DOMTokenList принимает одно или несколько из трех возможных значений: nodownload , nofullscreen и noremoteplayback .

HTMLMediaElement.crossOrigin

Строка, указывающая настройку CORS для этого медиа-элемента.

HTMLMediaElement.currentSrc Только чтение

Возвращает строку с абсолютным URL-адресом выбранного медиа-ресурса.

HTMLMediaElement.currentTime

Значение двойной точности с плавающей запятой, указывающее текущее время воспроизведения в секундах; если медиаданные не начали воспроизводиться и поиск не выполнялся, это значение является начальным временем воспроизведения медиафайлов. Установка этого значения ищет носитель на новое время. Время указывается относительно временной шкалы носителя.

HTMLMediaElement.defaultMuted

Логическое значение, отражающее HTML-атрибут muted , указывающий, должен ли аудиовыход мультимедийного элемента быть отключен по умолчанию.

HTMLMediaElement.defaultPlaybackRate

A double указывает скорость воспроизведения по умолчанию для мультимедиа.

HTMLMediaElement.disableRemotePlayback

Логическое значение, которое устанавливает или возвращает состояние удаленного воспроизведения, указывающее, разрешено ли медиа-элементу иметь пользовательский интерфейс удаленного воспроизведения.

HTMLMediaElement.duration
Только чтение

Доступное только для чтения значение двойной точности с плавающей запятой, указывающее общую продолжительность мультимедиа в секундах. Если данные мультимедиа недоступны, возвращается значение NaN . Если мультимедиа имеет неопределенную длину (например, потоковое мультимедиа в реальном времени, мультимедиа вызовов WebRTC и т. д.), значение равно 9.0004 +Бесконечность .

HTMLMediaElement.ended Только чтение

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

HTMLMediaElement.error Только чтение

Возвращает объект MediaError для самой последней ошибки или null , если ошибки не было.

HTMLMediaElement.loop

Логическое значение, отражающее HTML-атрибут цикла , указывающий, должен ли медиа-элемент начинаться заново, когда он достигает конца.

HTMLMediaElement.mediaKeys Только чтение

Возвращает объект MediaKeys или null . MediaKeys — это набор ключей, которые связанный элемент HTMLMediaElement может использовать для расшифровки мультимедийных данных во время воспроизведения.

HTMLMediaElement.muted

Логическое значение, определяющее, отключен ли звук. true , если звук отключен, и false в противном случае.

HTMLMediaElement.networkState Только чтение

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

HTMLMediaElement.paused Только чтение

Возвращает логическое значение, указывающее, приостановлен ли медиа-элемент.

HTMLMediaElement.playbackRate

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

HTMLMediaElement.played Только чтение

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

HTMLMediaElement.preload

Строка, отражающая

preload Атрибут HTML, указывающий, какие данные должны быть предварительно загружены, если таковые имеются. Возможные значения: нет , метаданные , авто .

HTMLMediaElement.preservesPitch

Логическое значение, определяющее, будет ли сохранена высота звука. Если установлено значение false , высота тона будет соответствовать скорости звука.

HTMLMediaElement.readyState Только чтение

Возвращает беззнаковое короткое (перечисление), указывающее состояние готовности носителя.

HTMLMediaElement.seekable
Только чтение

Возвращает объект TimeRanges , содержащий временные диапазоны, которые пользователь может найти, если они есть.

HTMLMediaElement.seeking Только чтение

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

HTMLMediaElement.sinkId Только чтение Экспериментальный

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

значений MediaDeviceInfo.deviceid , возвращенных из MediaDevices.enumerateDevices() , id-multimedia или id-коммуникаций .

HTMLMediaElement.src

Строка, отражающая HTML-атрибут src , который содержит URL-адрес используемого медиаресурса.

HTMLMediaElement.
srcObject

MediaStream , представляющий медиафайл для воспроизведения или воспроизведенный в текущем HTMLMediaElement или null , если он не назначен.

HTMLMediaElement.textTracks Только чтение

Возвращает объект TextTrackList , содержащий список объектов TextTrack , содержащихся в элементе.

HTMLMediaElement.videoTracks Только чтение

Возвращает объект VideoTrackList , содержащий список объектов VideoTrack , содержащихся в элементе.

HTMLMediaElement.volume

двойной , указывающий громкость звука, от 0,0 (тихий) до 1,0 (самый громкий).

Обработчики событий

HTMLMediaElement.onencrypted

Устанавливает обработчик событий, вызываемый при шифровании носителя.

HTMLMediaElement.onwaitingforkey

Устанавливает обработчик событий, вызываемый, когда воспроизведение блокируется во время ожидания ключа шифрования.

Эти свойства устарели и не должны использоваться, даже если браузер все еще поддерживает их.

HTMLMediaElement.controller Устаревший Нестандартный

Объект MediaController , представляющий медиа-контроллер, назначенный элементу, или null , если ни один не назначен.

HTMLMediaElement.mediaGroup Устаревший Нестандартный

Строка, отражающая медиагруппу Атрибут HTML, указывающий имя группы элементов, к которой он принадлежит. Группа медиа-элементов имеет общий MediaController .

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

Возвращает логическое значение. Относится к захвату аудиопотока.

HTMLMediaElement.mozFragmentEnd Нестандартный Устаревший

Двойной , который обеспечивает доступ к времени окончания фрагмента, если элемент мультимедиа имеет URI фрагмента для currentSrc , в противном случае он равен продолжительности мультимедиа.

Этот интерфейс также наследует методы от своих предков HTMLElement , Element , Node и EventTarget .

HTMLMediaElement.addTextTrack()

Добавляет новый объект TextTrack (например, дорожку для субтитров) к элементу мультимедиа. Это только программный интерфейс, который не влияет на DOM.

HTMLMediaElement.captureStream()

Возвращает MediaStream , захватывает поток медиаконтента.

HTMLMediaElement.canPlayType()

Учитывая строку, определяющую тип носителя MIME (возможно, с codecs включен параметр), canPlayType() возвращает строку , вероятно, , если медиафайл должен воспроизводиться, , возможно, , если недостаточно информации, чтобы определить, будет ли медиафайл воспроизводиться или нет, или пустую строку, если медиафайл нельзя играть.

HTMLMediaElement.fastSeek()

Быстрый поиск заданного времени с низкой точностью.

HTMLMediaElement.load()

Сбрасывает носитель на начало и выбирает наилучший доступный источник из источников, предоставленных с использованием атрибута src или элемента .

HTMLMediaElement.pause()

Приостанавливает воспроизведение мультимедиа.

HTMLMediaElement.play()

Начинает воспроизведение мультимедиа.

HTMLMediaElement.seekToNextFrame() Устаревший

Переход к следующему кадру в медиа. Этот нестандартный экспериментальный метод позволяет вручную управлять чтением и рендерингом мультимедиа с заданной скоростью или покадрово перемещаться по мультимедиа для выполнения фильтрации или других операций.

HTMLMediaElement.setMediaKeys()

Возвращает Обещание . Устанавливает ключи MediaKeys для использования при расшифровке мультимедиа во время воспроизведения.

HTMLMediaElement.setSinkId()

Устанавливает идентификатор аудиоустройства, которое будет использоваться для вывода, и возвращает обещание . Это работает только тогда, когда приложению разрешено использовать указанное устройство.

Эти методы устарели и не должны использоваться, даже если браузер их все еще поддерживает.

HTMLMediaElement.mozCaptureStream() Нестандартный

[введите описание]

HTMLMediaElement.mozCaptureStreamUntilEnded() Нестандартный Устаревший

[введите описание]

HTMLMediaElement. mozGetMetadata() Нестандартный Устаревший

Возвращает Object , который содержит свойства, представляющие метаданные воспроизводимого медиа-ресурса в виде {ключ: значение} пар. При каждом вызове метода возвращается отдельная копия данных. Этот метод должен вызываться после того, как сработает событие loadmetadata.

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

прервать

Инициировано, когда ресурс не был полностью загружен, но не в результате ошибки.

канплей

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

можно проиграть

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

изменение длительности

Вызывается при обновлении свойства продолжительности.

опорожнен

Запускается, когда носитель становится пустым; например, когда носитель уже загружен (или частично загружен) и вызывается метод HTMLMediaElement.load() для его перезагрузки.

завершено

Возникает, когда воспроизведение останавливается при достижении конца медиафайла (<аудио> или <видео>) или из-за отсутствия дополнительных данных.

ошибка

Возникает, когда ресурс не может быть загружен из-за ошибки.

загруженные данные

Вызывается после завершения загрузки первого кадра носителя.

загруженные метаданные

Инициировано, когда метаданные были загружены.

запуск нагрузки

Возникает, когда браузер начал загружать ресурс.

пауза

Запускается, когда обрабатывается запрос на приостановку воспроизведения и действие переходит в состояние паузы, что чаще всего происходит при вызове метода HTMLMediaElement.pause() носителя.

играть

Возникает, когда свойство paused изменяется с true на false в результате применения метода HTMLMediaElement.play() или метода атрибут автозапуска .

игра

Возникает, когда воспроизведение готово к началу после паузы или задержки из-за отсутствия данных.

прогресс

Возникает периодически, когда браузер загружает ресурс.

изменение скорости

Срабатывает при изменении скорости воспроизведения.

изменить размер

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

искал

Запускается после завершения операции поиска.

поиск

Запускается, когда начинается операция поиска.

заглох

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

приостановить

Возникает, когда загрузка медиаданных была приостановлена.

обновление времени

Запускается, когда время, указанное в свойстве currentTime , обновляется.

изменение громкости

Срабатывает при изменении громкости.

ожидание

Возникает, когда воспроизведение остановлено из-за временного отсутствия данных.

2

загрузка только таблиц BCD браузера. Включите JavaScript для просмотра данных.

Ссылки

  • <видео> и <аудио> Элементы HTML
  • Интерфейсы HTMLVideoElement и HTMLAudioElement , производные от HTMLMediaElement

Руководства

  • Технологии веб-медиа
  • Область обучения: видео- и аудиоконтент
  • Руководство по типам и форматам мультимедиа в Интернете
  • Обработка проблем поддержки мультимедиа в веб-содержимом

Последнее изменение: , участниками MDN

mediaelement — Библиотеки — cdnjs

Версия

Тип актива

Некоторые файлы скрыты, нажмите, чтобы показать все файлы

Спецификация
Стандарт HTML
# htmlmediaelement