MediaStream:active 屬性

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來,它已在瀏覽器中提供。

activeMediaStream 介面的一個只讀屬性,它返回一個布林值,表示流當前是否處於活動狀態;如果流處於活動狀態,則返回 true,否則返回 false。當流中至少有一個 MediaStreamTrackMediaStreamTrack.readyState 屬性不為 ended 時,該流就被認為是活動的。一旦所有軌道都結束了,流的 active 屬性就會變為 false

如果流當前處於活動狀態,則返回 true;否則返回 false

示例

在此示例中,使用 getUserMedia() 請求一個源自使用者本地攝像頭和麥克風的新流。當該流可用時(即,當返回的 Promise fulfilled 時),頁面上的一個按鈕會根據流當前是否處於活動狀態進行更新。

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

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

規範

規範
媒體捕獲和流
# dom-mediastream-active

瀏覽器相容性