AudioTrack: свойство enabled

Свойство AudioTrack enabled указывает, включен ли в данный момент описанный аудиотрек. Если трек отключён, установив enabled в false, трек будет выключен и не будет воспроизводить звук.

Свойство enabled является булевым, значение которого true если трек включён; включённые треки воспроизводят звук во время воспроизведения медиа. Установка enabled в false фактически выключает аудиодорожку, предотвращая её вклад в звуковое воспроизведение медиа.

В этом примере происходит переключение между основным и комментарийным аудиодорожками элемента медиа.

function swapCommentaryMain() {
  const videoElem = document.getElementById("main-video");
  let audioTrackMain;
  let audioTrackCommentary;

  videoElem.audioTracks.forEach((track) => {
    if (track.kind === "main") {
      audioTrackMain = track;
    } else if (track.kind === "commentary") {
      audioTrackCommentary = track;
    }
  });

  if (audioTrackMain && audioTrackCommentary) {
    const commentaryEnabled = audioTrackCommentary.enabled;
    audioTrackCommentary.enabled = audioTrackMain.enabled;
    audioTrackMain.enabled = commentaryEnabled;
  }
}

Функция swapCommentaryMain() выше ищет внутри аудиодорожек элемента <video> "main-video" аудиодорожки, значения kind которых равны "main" и "commentary". Это представляют собой основную аудиодорожку и дорожку комментариев.

Аудиодорожки элемента затем сканируются с помощью JavaScript метода forEach() (хотя свойство audioTracks элемента медиа фактически не является массивом JavaScript, но к нему можно обратиться как к таковому в большинстве случаев).

Сканирование ищет дорожки, значения kind которых равны "main" и "commentary" и запоминает эти объекты AudioTrack. После того, как они были найдены, значения свойств enabled двух дорожек меняются местами, что приводит к тому, что одна из двух дорожек становится активной.