MediaStream: Methode getAudioTracks()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Die getAudioTracks()-Methode des MediaStream-Interfaces gibt eine Sequenz zurück, die alle MediaStreamTrack-Objekte im Track-Set dieses Streams darstellt, bei denen MediaStreamTrack.kind audio ist.

Syntax

js
getAudioTracks()

Parameter

Keine.

Rückgabewert

Ein Array von MediaStreamTrack-Objekten, eines für jeden im Stream enthaltenen Audiotrack. Audiotracks sind jene Tracks, deren kind-Eigenschaft audio ist. Das Array ist leer, wenn der Stream keine Audiotracks enthält.

Hinweis: Die Reihenfolge der zurückgegebenen Tracks wird von der Spezifikation nicht definiert und kann sich tatsächlich von einem Aufruf von getAudioTracks() zum nächsten ändern.

Frühere Versionen dieser API enthielten ein spezielles AudioStreamTrack-Interface, das als Typ für jeden Eintrag in der Liste der Audiostreams verwendet wurde; dies wurde jedoch inzwischen in das Haupt-MediaStreamTrack-Interface integriert.

Beispiele

Dieses Beispiel erhält den Audio- und Videostream einer Webcam mit getUserMedia(), bringt den Stream in ein <video>-Element ein und setzt dann einen Timer, der beim Ablaufen den ersten im Stream gefundenen Audiotrack stoppt.

js
navigator.mediaDevices
  .getUserMedia({ audio: true, video: true })
  .then((mediaStream) => {
    document.querySelector("video").srcObject = mediaStream;
    // Stop the audio stream after 5 seconds
    setTimeout(() => {
      const tracks = mediaStream.getAudioTracks();
      tracks[0].stop();
    }, 5000);
  });

Spezifikationen

Specification
Media Capture and Streams
# dom-mediastream-getaudiotracks

Browser-Kompatibilität