Аудиодорожка

Интерфейс AudioTrack представляет собой отдельную аудиодорожку из одного из HTML-медиаэлементов, <audio> или <video>.

Наиболее распространённое использование объекта AudioTrack заключается в переключении его свойства enabled для отключения и включения звука дорожки.

enabled

Булево значение, которое управляет включением/выключением звука аудиодорожки. Установка этого значения в false отключает звук дорожки.

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

Строка, которая уникально идентифицирует дорожку в медиаданных. Этот идентификатор можно использовать для поиска конкретной дорожки в списке аудиодорожек, вызвав AudioTrackList.getTrackById(). Идентификатор также может использоваться как фрагмент URL, если медиа поддерживает поиск по фрагментам медиа в соответствии со спецификацией URI фрагментов медиа.

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

Строка, определяющая категорию, к которой принадлежит дорожка. Например, основная аудиодорожка будет иметь kind "main".

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

Строка, предоставляющая удобочитаемое имя дорожки. Например, аудиокомментарий к фильму может иметь label "Commentary with director John Q. Public and actors John Doe and Jane Eod." . Эта строка пуста, если метка не указана.

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

Строка, определяющая основной язык аудиодорожки или пустая строка, если язык неизвестен. Язык задаётся в формате BCP 47 (RFC 5646), например "en-US" или "pt-BR".

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

SourceBuffer создавший дорожку. Возвращает null, если дорожка не была создана с помощью SourceBuffer или если SourceBuffer был удалён из атрибута MediaSource.sourceBuffers родительского источника медиа.

Чтобы получить AudioTrack для данного медиаэлемента, используйте свойство audioTracks элемента, которое возвращает объект AudioTrackList, из которого можно получить отдельные дорожки, содержащиеся в медиа:

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

Затем вы можете получить доступ к отдельным дорожкам медиа, используя синтаксис массивов или функции, такие как forEach().

В этом первом примере берется первая аудиодорожка в медиа:

const firstTrack = tracks[0];

Следующий пример просматривает все аудиодорожки медиа, включая те, которые на языке пользователя (взятом из переменной userLanguage), и отключает остальные.

tracks.forEach((track) => {
  track.enabled = track.language === userLanguage;
});

Свойство language находится в стандартном формате (RFC 5646). Для английского языка США это будет, например, "en-US".

См. AudioTrack.label для примера получения массива типов и названий дорожек для указанного медиаэлемента, отфильтрованного по типу.