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

Свойства

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

HTMLMediaElement.audioTracks

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

HTMLMediaElement.autoplay

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

Примечание:Сайты, которые автоматически воспроизводят аудио (или видео с аудиодорожкой), могут быть неприятными для пользователей, поэтому их следует по возможности избегать. Если вы должны предлагать функцию автозапуска, вы должны включить её (требуется, чтобы пользователь специально включил её). Однако это может быть полезно при создании элементов мультимедиа, источник которых будет установлен позднее под контролем пользователя.

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

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

HTMLMediaElement.controller

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

HTMLMediaElement.controls

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

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

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

HTMLMediaElement.crossOrigin

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

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

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

HTMLMediaElement.currentTime

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

HTMLMediaElement.defaultMuted

ЯвляетсяBoolean, который отражает атрибут HTMLmuted, который указывает, должен ли звук вывода медиа-элемента по умолчанию отключаться.

HTMLMediaElement.defaultPlaybackRate

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

HTMLMediaElement.disableRemotePlayback

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

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

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

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

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

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

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

HTMLMediaElement.loop

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

HTMLMediaElement.mediaGroup

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

HTMLMediaElement.mediaKeysТолько для чтенияЭкспериментальная возможность

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

HTMLMediaElement.mozAudioCapturedТолько для чтенияНе стандартно

ВозвращаетBoolean. Связанный с захватом аудиопотока.

HTMLMediaElement.mozFragmentEndНе стандартно

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

HTMLMediaElement.mozFrameBufferLengthНе стандартноУстарело

Это unsigned long, который указывает число выборок, которые будут возвращены в кадровом буфере каждого события MozAudioAvailable. Это число является общим для всех каналов, и по умолчанию установлено количество каналов * 1024 (например, 2 канала * 1024 выборок = всего 2048).

Для свойства mozFrameBufferLength может быть установлено новое значение для более низкой задержки, больших объёмов данных и т. Д. Указанный размер должен быть числом от 512 до 16384. Использование любого другого размера приводит к возникновению исключения. Лучшее время для установки новой длины - после того, как сработало событие загруженных метаданных, когда известна аудиоинформация, но до того, как аудио началось, или события MozAudioAvailable начали срабатывать.

HTMLMediaElement.mozSampleRateТолько для чтенияНе стандартноУстарело

Возвращает двойное число, представляющее количество семплов в секунду, которые будут воспроизведены. Например, 44100 выборок в секунду - это частота дискретизации, используемая аудио CD.

HTMLMediaElement.muted

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

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

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

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

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

HTMLMediaElement.playbackRate

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

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

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

HTMLMediaElement.preload

ЭтоDOMString, который отражает атрибут HTMLpreload, указывающий, какие данные должны быть предварительно загружены, если таковые имеются. Возможные значения:none,metadata,auto.

HTMLMediaElement.preservesPitchНе стандартно

ЯвляетсяBoolean, который определяет, будет ли сохранена высота звука. Если установлено значение false, высота звука будет регулироваться в зависимости от скорости звука. Это реализовано с помощью префиксов в Firefox (mozPreservedPitch) и WebKit (webkitPreservedPitch).

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

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

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

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

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

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

HTMLMediaElement.sinkIdТолько для чтенияЭкспериментальная возможность

ВозвращаетDOMString, который является уникальным идентификатором аудиоустройства, предоставляющего выходные данные, или пустую строку, если используется пользовательский агент по умолчанию. Этот идентификатор должен быть одним из значений MediaDeviceInfo.deviceid, возвращаемых изMediaDevices.enumerateDevices (), id-multimedia или id-communications.

HTMLMediaElement.src

ЭтоDOMString, который отражает атрибут HTMLsrc, который содержит URL-адрес используемого медиа-ресурса.

HTMLMediaElement.srcObject

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

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

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

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

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

HTMLMediaElement.volume

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

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

HTMLMediaElement.onencrypted

УстанавливаетEvent Handler, вызываемый, когда носитель зашифрован.

HTMLMediaElement.onwaitingforkey

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

Устаревшие атрибуты

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

HTMLMediaElement.initialTimeТолько для чтенияНе стандартно

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

HTMLMediaElement.mozChannelsТолько для чтенияНе стандартноУстарело

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

Устаревшие обработчики событий

HTMLMediaElement.onmozinterruptbeginНе стандартно

УстанавливаетEventHandler, вызываемый, когда медиа-элемент прерывается из-за менеджера аудио-каналов. Это было специфично для Firefox, оно было реализовано для Firefox OS и было удалено в Firefox 55.

HTMLMediaElement.onmozinterruptendНе стандартно

УстанавливаетEvent Handler, вызываемый при завершении прерывания. Это было специфично для Firefox, оно было реализовано для Firefox OS и было удалено в Firefox 55.

Методы

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

HTMLMediaElement.addTextTrack()

Добавляет текстовую дорожку (например, дорожку для субтитров) к элементу мультимедиа.

HTMLMediaElement.captureStream()Экспериментальная возможность

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

HTMLMediaElement.canPlayType()

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

HTMLMediaElement.fastSeek()

Прямо стремится к данному времени.

HTMLMediaElement.load()

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

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

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

HTMLMediaElement.mozCaptureStreamUntilEnded()Не стандартно

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

HTMLMediaElement.mozGetMetadata()Не стандартно

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

HTMLMediaElement.pause()

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

HTMLMediaElement.play()

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

HTMLMediaElement.seekToNextFrame()Не стандартноЭкспериментальная возможность

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

HTMLMediaElement.setMediaKeys()Экспериментальная возможность

ВозвращаетПромис. Устанавливает клавишиMediaKeys, используемые при дешифровании медиафайлов во время воспроизведения.

HTMLMediaElement.setSinkId()Экспериментальная возможность

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

Устаревшие методы

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

HTMLMediaElement.mozLoadFrom()Не стандартноУстарело

Этот метод, доступный только в реализации Mozilla, загружает данные из другого медиа-элемента. Это работает аналогично load () за исключением того, что вместо обычного алгоритма выбора ресурса для источника просто устанавливается значение currentSrc другого элемента. Это оптимизировано, так что этот элемент получает доступ ко всем кешированным и буферизованным данным другого элемента; фактически эти два элемента совместно используют загруженные данные, поэтому данные, загруженные любым из этих элементов, доступны обоим.

События

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

abort

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

canplay

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

canplaythrough

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

durationchange

Запускается, когда атрибут продолжительности был обновлён.

emptied

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

ended

Срабатывает, когда воспроизведение останавливается, когда достигнут конец носителя (<audio> или <video>) или если дальнейшие данные недоступны.

error

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

loadeddata

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

loadedmetadata

Запускается, когда метаданные были загружены

loadstart

Запускается, когда браузер начал загружать ресурс.

pause

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

play

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

playing

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

progress

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

ratechange

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

seeked

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

seeking

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

stalled

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

suspend

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

timeupdate

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

volumechange

Запускается при изменении громкости.

waiting

Срабатывает, когда воспроизведение остановлено из-за временной нехватки данных

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

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

Смотрите также

• Рекомендации

  • <video> и<audio> HTML-элементы.
  • HTMLVideoElement иHTMLAudioElement интерфейсы, полученные из HTMLMediaElement.

• Статьи

  • Использование HTML5 аудио и видео
  • Медиа форматы, поддерживаемые аудио и видео элементами
  • API веб-аудио