MediaStream: getAudioTracks()-Methode

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 der MediaStream-Schnittstelle gibt eine Sequenz zurück, die alle MediaStreamTrack-Objekte im track set des Streams repräsentiert, bei denen MediaStreamTrack.kind audio ist.

Syntax

js
getAudioTracks()

Parameter

Keine.

Rückgabewert

Ein Array von MediaStreamTrack-Objekten, jeweils eines für jeden Audiotrack im Stream. 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 ist durch die Spezifikation nicht definiert und kann sich tatsächlich von einem Aufruf der getAudioTracks()-Methode zum nächsten ändern.

In frühen Versionen dieser API gab es eine spezielle AudioStreamTrack-Schnittstelle, die als Typ für jeden Eintrag in der Liste der Audiostreams verwendet wurde; dies wurde jedoch inzwischen in die Haupt- MediaStreamTrack-Schnittstelle integriert.

Beispiele

Dieses Beispiel bezieht den Audio- und Videostream einer Webcam mit getUserMedia(), fügt den Stream einem <video>-Element hinzu und legt dann einen Timer fest, der beim Auslaufen 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

BCD tables only load in the browser