MediaStream: active-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft active der Schnittstelle MediaStream gibt einen booleschen Wert zurück. Dieser ist true, wenn der Stream derzeit aktiv ist; andernfalls ist er false. Ein Stream gilt als aktiv, wenn bei mindestens einem seiner MediaStreamTrack-Objekte die Eigenschaft MediaStreamTrack.readyState nicht auf ended gesetzt ist. Sobald alle Tracks beendet sind, wird die Eigenschaft active des Streams zu false.
Wert
Ein boolescher Wert, der true ist, wenn der Stream derzeit aktiv ist; andernfalls ist er false.
Beispiele
In diesem Beispiel wird mit getUserMedia() ein neuer Stream angefordert, dessen Quelle die lokale Kamera und das Mikrofon der Benutzerin oder des Benutzers sind. Sobald der Stream verfügbar ist (das heißt, sobald das zurückgegebene Promise erfüllt ist), wird eine Schaltfläche auf der Seite entsprechend dem aktuellen Wert der Eigenschaft active aktualisiert.
const promise = navigator.mediaDevices.getUserMedia({
audio: true,
video: true,
});
promise.then((stream) => {
const startBtn = document.querySelector("#startBtn");
startBtn.disabled = stream.active;
});
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediastream-active |