active

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.

Свойство только для чтения active интерфейса MediaStream возвращает логическое значение, которое может быть true, если стрим активен; во всех остальных случаях, будет возвращён false. Стрим считается активным, если хотя бы один из MediaStreamTrack не находится в состоянии MediaStreamTrack.ended. Как только все track завершатся, свойство active переключится в состояние false.

Синтаксис

var isActive = MediaStream.active;

Значение

Логическое значение равно true, если стрим активен; в противном случае, возвращается false.

Пример

В этом примере, стрим ведётся с пользовательского микрофона и веб-камеры, запрошенных с помощью getUserMedia(). Когда стрим становится активным (а это тогда, когда выполнен Promise, кнопка на странице обновляется, опираясь на состояние стрима, активен он или же нет.

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

promise.then(function(stream) {
  var startBtn = document.querySelector('#startBtn');
  startBtn.disabled = stream.active;
};)

Спецификации

Specification
Media Capture and Streams
# dom-mediastream-active

Совместимость с браузерами

BCD tables only load in the browser