MediaElement
Наследник Element
autoplay
Если имеет значение true, проигрыватель автоматически начнет проигрывание, когда будет загружен достаточный объем данных. Соответствует HTML-атрибуту autoplay.
buffered
Фрагменты уже загруженных в буфер данных TimeRanges
.
controls
Если имеет значение true, проигрыватель должен отобразить элементы управления проигрыванием. Соответствует HTML-атрибуту controls.
currentSrc
URL-адрес мультимедийных данных, полученный из атрибута src или из одногоиз дочерних элементов <source>, или пустая строка, если данные для проигрывания не указаны.
currentTime
Текущая позиция проигрывания в секундах. Установка этого свойства позволяет перейти к другой позиции проигрывания.
defaultPlaybackRate
Скорость проигрывания, используемая при проигрывании в нормальном режиме. Значение по умолчанию 1.0.
duration
Продолжительность записи в секундах. Если продолжительность неизвестна (например, когда метаданные еще не были загружены), это свойство имеет значение NaN. Если проигрываются потоковые данные с неопределенной продолжительностью, это свойство имеет значение Infinity.
ended
Имеет значение true, если достигнут конец записи.
error
Это свойство устанавливается, когда возникает ошибка, в противном случае имеет значение null. Ссылается на объект MediaError
, свойство code которого описывает тип ошибки.
initialTime
Начальная позиция проигрывания в секундах. Обычно имеет значение 0, но в не которых случаях (например, когда проигрываются потоковые данные) может иметь различные значения.
loop
Если имеет значение true, проигрыватель должен автоматически перезапускать воспроизведение записи по достижении конца. Это свойство соответствует HTML-атрибуту loop.
muted
Определяет, должна ли воспроизводиться запись без звука. Это свойство можно использовать, чтобы отключать и включать звук. Для элементов <video> можно использовать атрибут audio=”muted”, чтобы отключить звук по умолчанию.
networkState
Определяет, загружаются данные в настоящий момент или нет. Допустимые значения перечислены в разделе «Константы» выше.
NETWORK_EMPTY = 0, Элемент еще не приступил к использованию сети. Это состояние предшествует установке атрибута src.
NETWORK_IDLE = 1, В настоящий момент элемент не производит загрузку данных из сети. Возможно, он уже загрузил ресурс полностью или загрузил необходимый объем данных в буфер. Или, возможно, свойство preload установлено в значение «none», и пока не была запрошена загрузка или проигрывание данных.
NETWORK_LOADING = 2, В настоящее время элемент загружает данные из сети.
NETWORK_NO_SOURCE = 3, Элемент не использует сеть, потому что не способен отыскать источник с данными для проигрывания.
onabort
Элемент прекратил загрузку данных, вероятно, по запросу пользователя. Свойство error.code имеет значение error.MEDIA_ERR_ABORTED.
oncanplay
Загружено достаточно данных, чтобы начать проигрывание, но наверняка потребуется загрузка дополнительных данных.
oncanplaythrough
Загружено достаточно данных, чтобы проигрывание не приостанавливалось на загрузку дополнительных данных.
ondurationchange
Изменилось значение свойства duration.
onemptied
Свойство networkState пол учило значение NETWORK_EMPTY вследствие ошибки или остановки проигрывателя.
onended
Проигрывание остановлено по достижении конца записи.
onerror
Сетевая или какая-то другая ошибка препятствует загрузке данных. Свойство error.code имеет значение, отличное от MEDIA_ERR_ABORTED (MediaError).
onloadeddata
Данные для текущей позиции проигрывания загружены в первый раз.
onloadedmetadata
Были загружены метаданные, и стали доступны продолжительность и размеры кадра.
onloadstart
Элемент послал запрос на загрузку данных.
onpause
Был вызван метод pause(), и проигрывание было приостановлено.
onplay
Был вызван метод play(), или атрибут autoplay вызвал запуск проигрывания.
onplaying
Данные проигрываются.
onprogress
Загрузка данных из сети продолжается. Обычно генерируется от 2 до 8 раз в секунду. Обратите внимание, что объект, связанный с этим событием, является обычным объектом Event, а не ProgressEvent, используемым другими прикладными интерфейсами, которые возбуждают события с именем «progress».
onratechange
Изменилось значение свойства playbackRate или defaultPlaybackRate.
onseeked
Свойство seeking опять получило значение false.
onseeking
Сценарий или пользователь потребовал выполнить переход к позиции проигрывания, для которой данные еще не были загружены, вследствие чего проигрывание было приостановлено до загрузки данных. Свойство seeking имеет значение true.
onstalled
Элемент пытается загрузить данные, но данные не поступают.
onsuspend
Элемент загрузил в буфер достаточно большой объем данных и временно приостановил загрузку.
ontimeupdate
Изменилось значение свойства currentTime. При обычном проигрывании это событие возбуждается от 4 до 60 раз в секунду.
onvolumechange
Изменилось значение свойства volume или muted.
onwaiting
Проигрывание не может быть начато, или проигрывание было приостановлено из-за недостаточного объема буферизованных данных. Когда будет загружен достаточный объем данных, последует событие «playing».
paused
Имеет значение true, если в настоящий момент проигрывание приостановлено.
playbackRate
Текущая скорость проигрывания. 1.0 – нормальная скорость проигрывания. Значения больше 1.0 соответствуют ускоренной скорости проигрывания вперед. Значения от 0 до 1.0 соответствуют замедленной скорости проигрывания вперед. Значения меньше 0 соответствуют проигрыванию в обратном направлении. (Звук всегда отключается при проигрывании в обратном направлении, а также при слишком быстром или слишком медленном проигрывании вперед.)
played
Фрагменты TimeRanges
, которые уже были проиграны.
preload
Это свойство соответствует HTML-атрибуту с тем же именем, и его можно использовать, чтобы указать, какой объем данных должен загрузить броузер, прежде чем пользователь сможет запустить проигрывание. Значение «none» означает, что предварительная загрузка данных не должна выполняться. Значение «metadata» означает, что броузер должен предварительно загрузить метаданные (такие как продолжительность), но не фактические данные. Значение «auto» (или просто пустая строка, если атрибут preload указан без значения) означает, что броузер может загрузить весь ресурс целиком на тот случай, если пользователь решит проиграть его.
readyState
Определяет готовность данных к проигрыванию, исходя из объема данных, загруженных в буфер.
HAVE_NOTHING = 0, Мультимедийные данные или метаданные еще не были загружены.
HAVE_METADATA = 1, Метаданные были загружены, но данные для текущей позиции проигрывания еще не были загружены. Это означает, что можно узнать продолжительность или размеры кадра видеозаписи, а также перейти к другой позиции проигрывания, изменив значение свойства currentTime, но броузер в настоящее время не проигры вает данные в позиции currentTime.
HAVE_CURRENT_DATA = 2, Данные для текущей позиции проигрывания currentTime были загружены, но данных пока недостаточно, чтобы можно было начать проигрывание. Для видеозаписей это обычно означает, что текущий кадр уже загружен, а следующий – еще нет. Это состояние возникает в конце аудио- или видеозаписи.
HAVE_FUTURE_DATA = 3, Загружен объем данных, достаточный, чтобы начать проигрывание, но, скорее всего, недостаточный, чтобы проиграть запись до конца без приостановки для загрузки дополнительных данных.
HAVE_ENOUGH_DATA = 4, Загружен объем данных, достаточный, чтобы броузер смог проиграть запись до конца без приостановки.
seekable
Фрагмент или фрагменты TimeRanges
, значения времени для которых могут быть присвоены свойству currentTime. При проигрывании простых файлов обычно можно установить любое значение от 0 до значения свойства duration. Но для потоковых данных позиция в прошлом может отсутствовать в буфере, а позиция в будущем может быть еще недоступна.
seeking
Имеет значение true, пока элемент проигрывателя выполняет переход к новой позиции проигрывания currentTime. Если данные для новой позиции проигрывания уже загружены в буфер, это свойство будет иметь значение true очень короткий промежуток времени. Но если для перехода проигрывателю необходимо загрузить новые данные, свойство seeking будет оставаться в значении true довольно продолжительное время.
src
Соответствует HTML-атрибуту src элемента проигрывателя. Присваивание нового значения этому свойству заставит проигрыватель загрузить новые данные для проигрывания. Не путайте это свойство со свойством currentSrc.
startOffsetTime
Действительные дата и время позиции проигрывания 0, если метаданные содержат такую информацию. (Видеофайл может содержать время съемки, например.)
volume
Определяет уровень громкости воспроизводимой аудиозаписи. Значение должно быть в диапазоне от 0 до 1. См. также описание свойства muted.
canPlayType
(string type)Этот метод запрашивает у элемента проигрывателя, способен ли он проигрыватьданные MIME-типа type. Если проигрыватель точно определит, что не может проигрывать данные указанного типа, он вернет пустую строку. Если проигрыватель полагает (но не уверен), что может проигрывать данные указанного типа, он вернет строку «probably» («возможно»). В общем случае элементы проигрывателя никогда не вернут строку «probably», если type не включает параметр codecs= со списком мультимедийных кодеков. Если проигрыватель не уверен, что может проигрывать данные указанного типа, этот метод вернет строку «maybe».
load
()Этот метод сбрасывает элемент проигрывателя в исходное состояние и заставляет его выбрать источник данных и начать загрузку. Это происходит автоматически, когда элемент впервые вставляется в документ, и всякий раз, когда изменяется значение атрибута src. Однако при добавлении, удалении или изменении вложен ных элементов <source> метод load() необходимо вызывать явно.
pause
()Приостанавливает проигрывание.
play
()Начинает проигрывание записи.