Список видеодорожек

Интерфейс VideoTrackList используется для представления списка видеодорожек, содержащихся в элементе <video>, причём каждая дорожка представлена отдельным объектом VideoTrack в списке.

Получить экземпляр этого объекта можно с помощью HTMLMediaElement.videoTracks. Доступ к отдельным дорожкам можно получить с помощью синтаксиса массивов или функций, таких как forEach().

Этот интерфейс также наследует свойства от своего родительского интерфейса EventTarget.

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

Количество дорожек в списке.

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

Индекс текущей выбранной дорожки, если таковая есть, или −1 в противном случае.

Этот интерфейс также наследует методы от своего родительского интерфейса EventTarget.

getTrackById()

Возвращает VideoTrack, найденную в VideoTrackList, идентификатор которой (id) соответствует указанной строке. Если совпадения не найдено, возвращается null.

addtrack

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

change

Срабатывает, когда видеодорожка стала активной или неактивной. Также доступно через свойство onchange.

removetrack

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

Помимо прямого доступа к видеодорожкам в элементе мультимедиа, VideoTrackList позволяет устанавливать обработчики событий на события addtrack и removetrack, чтобы определять добавление или удаление дорожек из потока элемента мультимедиа.

Чтобы получить список видеодорожек элемента мультимедиа, используйте свойство videoTracks.

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

В этом примере приложение отображает информацию о доступных каналах. Для поддержания актуальности настроены обработчики событий addtrack и removetrack.

videoTracks.onaddtrack = updateTrackCount;
videoTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = videoTracks.length;
  drawTrackCountIndicator(trackCount);
}