События в медиа (audio, video) объектах

Встроенные с помощью тегов <audio> или <video> в HTML медиа генерируют различные события. В этом разделе приведен их список и описание.

Название события	Описание
`abort`	Отправляется, когда воспроизведение прерывается; Например, если воспроизвдение медиа прерывается и начинается с самого начала, это событие будет отправлено.
`canplay`	Отправляется, когда доступно достаточно данных для того, что бы медиа могло воспроизвестись, по крайней мере, в течение нескольких кадров. Соответствует состоянию (readyState) HAVE_ENOUGH_DATA.
`canplaythrough`	Отправляется, когда состояние готовности изменяется к CAN_PLAY_THROUGH. Указывает, что медиа может быть полностью воспроизведено без перерыва, предполагая, что скорость загрузки остается, по крайней мере на нынешнем уровне. Примечание: Ручная установка CURRENTTIME вызовет событие canplaythrough в Firefox. В других браузерах это может не произойти.
`durationchange`	Метаданные были загружены или изменены, что указывает на изменение в продолжительности медиа. Может быть отправлено, например, когда медиа загружено достаточно для того, чтобы продолжительность уже была известна.
`emptied`	Медиа стало пустым. Например, это событие отправляется, если медиа уже загружено (или частично заргужено), и метод `load()` был вызван что бы его перезагрузить.
encrypted	The user agent has encountered initialization data in the media data.
`ended`	Отправляется, когда воспроизведение завершено.
`error`	Отправляется, когда произошла ошибка. Атрибут `error` медиа объекта содержит более подробную информацию об ошибке. Смотрите Error handling, что бы узнать подробнее.
`interruptbegin`	Sent when audio playing on a Firefox OS device is interrupted, either because the app playing the audio is sent to the background, or audio in a higher priority audio channel begins to play. See Using the AudioChannels API for more details.
`interruptend`	Sent when previously interrupted audio on a Firefox OS device commences playing again — when the interruption ends. This is when the associated app comes back to the foreground, or when the higher priority audio finished playing. See Using the AudioChannels API for more details.
`loadeddata`	Завершена загрузка первого кадра (frame) медиа.
`loadedmetadata`	Метаданные медиа были загружены; все атрибуты теперь содержат максимум информации.
`loadstart`	Отправляется, когда начинается загрузка медиа.
`mozaudioavailable`	Sent when an audio buffer is provided to the audio layer for processing; the buffer contains raw audio samples that may or may not already have been played by the time you receive the event.
`pause`	Отправляется, когда воспроизведение приостановлено.
`play`	Отправляется, когда воспроизведение медиа начинается после того, как было приостановлено; то есть, когда воспроизведение возобновляется после паузы.
`playing`	Отправляется, когда начинается воспроизведение медиа (в первый раз, после паузы или после перезапуска).
`progress`	Отправляется периодически для информирования о прогрессе скачивания медиа файла. Информация об объеме загруженных данных доступна в атрибуте "buffered" элемента медиа.
`ratechange`	Отправляется, когда изменяется скорость воспроизведения.
`seeked`	Отправляется, когда операция поиска завершена.
`seeking`	Отправляется, когда начинается операция поиска.
`stalled`	Sent when the user agent is trying to fetch media data, but data is unexpectedly not forthcoming.
`suspend`	Отправляется, когда загрузка медиа приостановлена. Это может прозойти как потому, что загрузка была завершена, так и по другим причинам.
`timeupdate`	Отправляется, когда изменяется значение атрибута `currentTime.`
`volumechange`	Отправляется, когда изменяется громкость звука (также когда звук включен или выключен).
`waiting`	Отправляется, когда операция (напр. воспроизведение) была отложена до завершение другой операции (напр. поиск).

Вы можете легко следить за этими событиями, используя код, такой как следующий:

var v = document.getElementsByTagName("video")[0];
v.addEventListener("seeked", function() { document.getElementsByTagName("video")[0].play(); }, true);
v.currentTime = 10.0;

Этот пример получает первый элемент видео в документе и вешает на него слушатель события "seeked". Обработчик просто вызывает метод элемента play(), который начинает воспроизведение.

TЗатем, в строке 3 примера, устанавливается атрибут currentTime элемента в значение 10.0, что инициирует переход к десятой секунде медиа. Это приводит к отправлению события "seeking" после начала операции, и события "seeked" после её завершения.

Другими словами, этот пример пытается перейти к 10-секундной отметке в медиа, после чего начинает воспроизведение.

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	?	3.5 (1.9.1) (Prior to Gecko 2.0, media events bubbled.)	?	?	?
encrypted	42.0	?	?	?	?
load	?	Removed in 3.6 (1.9.2)	?	?	?
mozaudioavailable	Нет	4.0 (2.0)	Нет	Нет	Нет
suspend	?	3.6 (1.9.2)	?	?	?

Feature	Android	Android Webview	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	?	?	?	?	?	?	?
encrypted	Нет	43.0	?	?	?	?	42.0
load	?	?	?	?	?	?	?
mozaudioavailable	Нет	?	4.0 (2.0)	Нет	Нет	Нет	?
suspend	?	?	?	?	?	?	?

События в медиа (audio, video) объектах

Совместимость

Метки документа и участники