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

Флэнаган Дэвид
Шрифт:

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

Объект

MessageChannel
представляет пару соединенных друг с другом объектов
MessagePort
. Вызов метода postMessage в любом из них сгенерирует событие «message* в другом. Если в программе потребуется создать частный канал связи с окном
Window
или фоновым потоком выполнения
Worker
, можно создать объект
MessageChannel
и затем передать один объект
MessagePort
из этой пары окну или потоку выполнения (используя аргумент ports метода
postMessage
).