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

  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.

Методы

  string canPlayType(string type)

Этот метод запрашивает у элемента проигрывателя, способен ли он проигрывать данные MIME-типа type. Если проигрыватель точно определит, что не может проигрывать данные указанного типа, он вернет пустую строку. Если проигрыватель полагает (но не уверен), что может проигрывать данные указанного типа, он вернет строку «probably» («возможно»). В общем случае элементы проигрывателя никогда не вернут строку «probably», если type не включает параметр codecs= со списком мультимедийных кодеков. Если проигрыватель не уверен, что может проигрывать данные указанного типа, этот метод вернет строку «maybe».

  void load

Этот метод сбрасывает элемент проигрывателя в исходное состояние и заставляет его выбрать источник данных и начать загрузку. Это происходит автоматически, когда элемент впервые вставляется в документ, и всякий раз, когда изменяется значение атрибута src. Однако при добавлении, удалении или изменении вложенных элементов <source> метод load необходимо вызывать явно.

  void pause

Приостанавливает проигрывание.

  void play

Начинает проигрывание записи.

MediaError

представляет ошибку в элементе <audio> или <video>

Когда в элементе <audio> или <video> возникает ошибка, генерируется событие «error» и в свойстве error объекта события обработчику передается объект MediaError. Свойство code этого объекта определяет тип возникшей ошибки. Возможные значения этого свойства определяют приведенные ниже константы.

Константы

 unsigned short MEDIA_ERR_ABORTED = 1

Пользователь остановил загрузку данных.

 unsigned short MEDIA_ERR_NETWORK = 2

Мультимедийные данные имеют корректный тип, но сетевая ошибка препятствует их загрузке.

 unsigned short MEDIA_ERR_DECODE = З

Мультимедийные данные имеют корректный тип, но ошибка кодирования препятствует их декодированию и проигрыванию.

 unsigned short MEDIA_ERR_SRC_NOT_SUPPORTED = 4

Тип мультимедийных данных, на которые ссылается атрибут src, не поддерживаются броузером.

Свойства

  readonly unsigned short code

Это свойство описывает тип возникшей ошибки. Его значением может быть одна из констант, перечисленных выше.

MessageChannel

пара соединенных объектов MessagePorts