Spec-Zone.ru › Web APIs

AudioTrackList: событие addtrack

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает во всех наиболее распространённых браузерах.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие addtrack срабатывает при добавлении трека в AudioTrackList.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

Тип события

Объект TrackEvent. Наследуется от Event.

Событие TrackEvent

Свойства события

TrackEvent основано на Event, поэтому свойства Event также доступны для объектов TrackEvent.

track Только для чтения

Объект DOM-трека, к которому относится событие. Если это не null, это всегда объект одного из типов медиа-треков: AudioTrack, VideoTrack или TextTrack.

Описание

Триггер

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

Это событие не отменяется и не распространяется.

Сценарии использования

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

Примеры

Использование addEventListener():

const videoElement = document.querySelector("video");

videoElement.audioTracks.addEventListener("addtrack", (event) => {
  console.log(`Audio track: ${event.track.label} added`);
});

Использование свойства обработчика событий onaddtrack:

const videoElement = document.querySelector("video");

videoElement.audioTracks.onaddtrack = (event) => {
  console.log(`Audio track: ${event.track.label} added`);
};

Спецификации

Спецификация
HTML
# event-media-addtrack
HTML
# handler-tracklist-onaddtrack

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
addtrack_event 37 7912–79 33 24 7 37 Нет Нет 7 Нет Нет

См. также

  • Связанные события: removetrack, change
  • Это событие для VideoTrackList относится к: addtrack
  • Это событие для MediaStream относится к: addtrack
  • API захвата медиа и потоков
  • WebRTC

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioTrackList/addtrack_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API