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 in der Track-Menge dieses Streams repräsentiert, bei denen MediaStreamTrack.kind audio ist.

Syntax

js
getAudioTracks()

Parameter

Keine.

Rückgabewert

Ein Array von MediaStreamTrack-Objekten, eines für jede Audiospur, die im Stream enthalten ist. Audiospuren sind diejenigen Spuren, deren kind-Eigenschaft audio ist. Das Array ist leer, wenn der Stream keine Audiospuren enthält.

Hinweis: Die Reihenfolge der zurückgegebenen Spuren ist in der Spezifikation nicht festgelegt und kann sich tatsächlich von einem Aufruf zu getAudioTracks() zum nächsten ändern.

Frühere Versionen dieser API enthalten eine spezielle AudioStreamTrack-Schnittstelle, die als Typ für jeden Eintrag in der Liste der Audiospuren verwendet wurde; dies wurde jedoch in die Hauptschnittstelle MediaStreamTrack integriert.

Beispiele

Dieses Beispiel erhält Audio und Video von einer Webcam in einem Stream über getUserMedia(), fügt den Stream an ein <video>-Element an und setzt dann einen Timer, der beim Ablauf die erste gefundene Audiospur im Stream 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