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; 
};)

仕様

ブラウザ互換性

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！