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
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.
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