MediaTrackSupportedConstraints:logicalSurface 屬性

可用性有限

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

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

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

如果裝置和使用者代理支援 logicalSurface 約束,則返回 true

示例

此方法設定約束物件,指定呼叫 getDisplayMedia() 的選項。它僅在已知瀏覽器支援 logicalSurface 約束時才新增該約束(要求僅包含邏輯顯示錶面——那些可能在螢幕上並非完全可見的表面——作為使用者可用的選項)。然後,透過呼叫 getDisplayMedia() 並將返回的流附加到變數 videoElem 引用的影片元素來啟動捕獲。

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

  if (supportedConstraints.logicalSurface) {
    displayMediaOptions.video.logicalSurface = "monitor";
  }

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

規範

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

瀏覽器相容性

另見