MediaStream: active-Eigenschaft

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.

js
const promise = navigator.mediaDevices.getUserMedia({
  audio: true,
  video: true,
});

promise.then((stream) => {
  const startBtn = document.querySelector("#startBtn");
  startBtn.disabled = stream.active;
});

Spezifikationen

Specification
Media Capture and Streams
# dom-mediastream-active

Browser-Kompatibilität

BCD tables only load in the browser