AudioTrack: enabled-Eigenschaft

Die enabled-Eigenschaft ist ein Boolean, dessen Wert true ist, wenn der Track aktiviert ist; aktivierte Tracks erzeugen Ton, während das Medium abgespielt wird. Wenn enabled auf false gesetzt wird, wird der Audiotrack effektiv stummgeschaltet und trägt nicht zur Audioleistung des Mediums bei.

Dieses Beispiel wechselt zwischen dem Haupt- und dem Kommentar-Audiotrack eines Medienelements.

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;
  }
}

Die oben gezeigte Funktion swapCommentaryMain() sucht innerhalb der Audiotracks des <video>-Elements "main-video" nach den Audiotracks, deren kind-Werte "main" und "commentary" sind. Diese repräsentieren den primären Audiotrack und den Kommentartrack.

Die Audiotracks des Elements werden dann mit der JavaScript-Methode forEach() durchsucht (obwohl die audioTracks-Eigenschaft eines Medienelements eigentlich kein JavaScript-Array ist, kann auf sie größtenteils wie auf ein solches zugegriffen werden).

Die Durchsuchung sucht nach den Tracks, deren kind-Werte "main" und "commentary" sind, und merkt sich diese AudioTrack-Objekte. Sobald diese gefunden wurden, werden die Werte der beiden enabled-Eigenschaften der Tracks ausgetauscht, was zu einem Wechsel führt, welcher der beiden Tracks gerade aktiv ist.