active

MediaStreamインタフェースのactiveは読み取り専用のプロパティいであり、ストリームが現在アクティブであればtrueを返し、それ以外の場合はfalseを返します。少なくとも一つのトラックの状態がMediaStreamTrack.endedでない場合、ストリームがアクティブであるとみなされます。すべでのトラックが終了すると、このストリームのactiveプロパティはfalseになります。

文法

var isActive = MediaStream.active;

値

このストリームが現在アクティブな場合はtrueを返します。それ以外はfalseを返します。

例

この例では、getUserMedia()を用いて、要求されたユーザーのローカルのカメラとマイクロフォンをソースとする新しいストリームを取得しています。ストリームが有効になると(ここでは、Promiseがfulfilledの状態になった時)、ストリームが現在アクティブであるかどうかに応じてページにあるボタンの状態が更新されます。

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

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

仕様

ブラウザ互換性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!