MediaStream: active-Eigenschaft

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
active

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support