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 active-Eigenschaft des MediaStream-Interfaces gibt einen booleschen Wert zurück, der true ist, wenn der Stream derzeit aktiv ist; andernfalls wird false zurückgegeben. Ein Stream wird als aktiv angesehen, wenn mindestens einer seiner MediaStreamTracks nicht die Eigenschaft MediaStreamTrack.readyState auf ended gesetzt hat. Sobald jeder Track beendet ist, wird die active-Eigenschaft des Streams false.
Wert
Ein boolescher Wert, der true ist, wenn der Stream derzeit aktiv ist; andernfalls ist der Wert false.
Beispiele
In diesem Beispiel wird ein neuer Stream angefordert, dessen Quelle die lokale Kamera und das Mikrofon des Benutzers ist, indem getUserMedia() verwendet wird. Wenn dieser Stream verfügbar wird (das heißt, wenn das zurückgegebene Promise erfüllt wird), wird ein Button auf der Seite basierend darauf aktualisiert, ob der Stream derzeit aktiv ist oder nicht.
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 |