AudioTrackList: событие addtrack
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает во всех наиболее распространённых браузерах.
Событие addtrack срабатывает при добавлении трека в AudioTrackList.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.
addEventListener("addtrack", (event) => { })
onaddtrack = (event) => { }
Тип события
Объект TrackEvent. Наследуется от Event.
Свойства события
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`);
};
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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