MediaTrackConstraints: logicalSurface 屬性

可用性有限

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

MediaTrackConstraints 字典的 logicalSurface 屬性是一個 ConstrainDOMString，用於描述對 logicalSurface 可約束屬性值所施加的請求或強制約束。

這用於指定 getDisplayMedia() 是否應允許使用者選擇不一定在螢幕上完全可見的顯示錶面，例如被遮擋的視窗，或者需要滾動才能看到全部內容的大視窗的全部內容。

如果需要，您可以透過呼叫 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.logicalSurface 的值來確定是否支援此約束。但是，通常這並不必要，因為瀏覽器會忽略它們不熟悉的任何約束。

值

一個 ConstrainBoolean，如果允許在使用者可選的邏輯表面中包含邏輯表面，則為 true。

有關約束的定義方式，請參閱如何定義約束。

您可以透過呼叫顯示媒體的影片 MediaStreamTrack 上的 getSettings() 來檢查使用者代理在建立顯示媒體後所選的設定，然後檢查返回的 MediaTrackSettings 物件的 logicalSurface 屬性的值。

例如，如果您的應用程式需要知道所選的顯示錶面是否為邏輯表面

let isLogicalSurface = displayStream
  .getVideoTracks()[0]
  .getSettings().logicalSurface;

遵循此程式碼，如果流中包含的顯示錶面是一個邏輯表面（即，可能並非完全在螢幕上，甚至可能完全在螢幕外），則 isLogicalSurface 為 true。

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

此頁面最後修改於 2024年5月14日，由 MDN 貢獻者修改。