Список аудиодорожек

Интерфейс AudioTrackList используется для представления списка аудиодорожек, содержащихся в заданном HTML-элементе медиа, при этом каждая дорожка представлена отдельным объектом AudioTrack в списке.

Получить экземпляр этого объекта с помощью HTMLMediaElement.audioTracks. К отдельным дорожкам можно получить доступ, используя синтаксис массивов.

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

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

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

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

getTrackById()

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

addtrack

Срабатывает, когда новая аудиодорожка добавлена в элемент медиа.

change

Срабатывает, когда дорожка была включена или выключена.

removetrack

Срабатывает, когда новая аудиодорожка удалена из элемента медиа.

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

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

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

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

audioTracks.onaddtrack = updateTrackCount;
audioTracks.onremovetrack = updateTrackCount;

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