JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

Фрагменты уже загруженных в буфер данных.

boolean controls

Если имеет значение true, проигрыватель должен отобразить элементы управления проигрыванием. Соответствует HTML-атрибуту

controls

.

readonly string currentSrc

URL-адрес мультимедийных данных, полученный из атрибута

src

или из одного из дочерних элементов

<source>,

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

double currentTime

Текущая

позиция проигрывателя в секундах. Установка этого свойства позволяет перейти к другой позиции проигрывателя.

double defaultPlaybackRate

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

readonly double duration

Продолжительность записи в секундах. Если продолжительность неизвестна (например, когда метаданные еще не были загружены), это свойство имеет значение NaN. Если проигрываются потоковые данные с неопределенной продолжительностью, это свойство имеет значение Infinity.

readonly boolean ended

Имеет значение true, если достигнут конец записи.

readonly MediaError error

Это свойство устанавливается, когда возникает ошибка, в противном случае имеет значение null. Ссылается на объект, свойство

code

которого описывает тип ошибки.

readonly double initialTime

Начальная позиция проигрывания в секундах. Обычно имеет значение 0, но в некоторых случаях (например, когда проигрываются потоковые данные) может иметь различные значения.

boolean loop

Если имеет значение true, проигрыватель должен автоматически перезапускать воспроизведение записи по достижении конца. Это свойство соответствует HTML-атрибуту

loop

.

boolean muted

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

<video>

можно использовать атрибут audio="muted", чтобы отключить звук по умолчанию.

readonly unsigned short networkState

Определяет, загружаются данные в настоящий момент или нет. Допустимые значения перечислены в разделе «Константы» выше.

readonly boolean paused

Имеет значение true, если в настоящий момент проигрывание приостановлено.

double playbackRate

Текущая скорость проигрывания. 1.0 - нормальная скорость проигрывания. Значения больше 1.0 соответствуют ускоренной скорости проигрывания вперед. Значения от 0 до 1.0 соответствуют замедленной скорости проигрывания вперед. Значения меньше 0 соответствуют проигрыванию в обратном направлении. (Звук всегда отключается при проигрывании в обратном направлении, а также при слишком быстром или слишком медленном проигрывании вперед.)

readonly TimeRanges played

Фрагменты, которые уже были проиграны.

string preload

Это свойство соответствует HTML-атрибуту с тем же именем, и его можно использовать, чтобы указать,

какой объем данных должен загрузить броузер, прежде чем пользователь сможет запустить проигрывание. Значение «попе» означает, что предварительная загрузка данных не должна выполняться. Значение «metadata» означает, что броузер должен предварительно загрузить метаданные (такие как продолжительность), но не фактические данные. Значение «auto» (или просто пустая строка, если атрибут

preload

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

readonly unsigned short readyState

Определяет готовность данных к проигрыванию, исходя из объема данных, загруженных в буфер. Допустимые значения определяются константами HAVE_, описанными выше.

readonly TimeRanges seekable

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

currentTime

. При проигрывании простых файлов обычно можно установить любое значение от 0 до значения свойства

duration

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

readonly boolean seeking

Имеет значение true, пока элемент проигрывателя выполняет переход к новой позиции проигрывания

currentTime

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

seeking

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

string src

Соответствует HTML-атрибуту

src

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

currentSrc

.

readonly Date startOffsetTime

Действительные дата и время позиции проигрывания 0, если метаданные содержат такую информацию. (Видеофайл может содержать время съемки, например.)

double volume

Определяет уровень громкости воспроизводимой аудиозаписи. Значение должно быть в диапазоне от 0 до 1. См. также описание свойства

muted

.

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

Теги

<audio>

и

<video>

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

addEventListener (EventTarget).

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

Event

.