MediaTrackSupportedConstraints: suppressLocalAudioPlayback 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

MediaTrackSupportedConstraints 字典的 suppressLocalAudioPlayback 屬性指示了使用者代理和使用內容的裝置是否支援 suppressLocalAudioPlayback 約束。

支援的約束列表透過呼叫 navigator.mediaDevices.getSupportedConstraints() 來獲取。

一個布林值,如果 suppressLocalAudioPlayback 約束得到裝置和使用者代理的支援,則為 true

示例

下面的函式設定了呼叫 getDisplayMedia() 的選項物件。它僅在已知瀏覽器支援 suppressLocalAudioPlayback 約束(要求捕獲的音訊不從使用者的本地揚聲器播放)時才新增此約束。然後透過呼叫 getDisplayMedia() 並將返回的流附加到變數 videoElem 引用的影片元素來啟動捕獲。

js
async function capture() {
  const supportedConstraints = navigator.mediaDevices.getSupportedConstraints();
  const displayMediaOptions = {
    audio: {},
  };

  if (supportedConstraints.suppressLocalAudioPlayback) {
    displayMediaOptions.audio.suppressLocalAudioPlayback = true;
  }

  try {
    videoElem.srcObject =
      await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
  } catch (err) {
    /* handle the error */
  }
}

規範

規範
螢幕捕獲
# dom-mediatrackconstraintset-suppresslocalaudioplayback

瀏覽器相容性

另見