MediaTrackSettings: logicalSurface 属性

The MediaTrackSettings dictionary's logicalSurface property indicates whether or not the display area being captured is a logical surface. Logical surfaces are those which are not necessarily entirely onscreen, or may even be off-screen, such as windows' backing buffers (where only part of the buffer is visible without scrolling the containing window) and offscreen rendering contexts.

如果捕获的视频流中的视频轨道来自逻辑显示表面,则为布尔值 true

显示表面可能是逻辑表面的最常见情况是,所选表面包含一个窗口的整个内容区域,而该窗口太大,无法一次显示在屏幕上。由于包含表面的窗口必须滚动才能显示其余内容,因此该表面是逻辑表面。

可见显示表面(即,logicalSurface 返回 false 的表面)是当前在屏幕上可见的逻辑显示表面的一部分。

例如,用户代理可能选择允许用户选择是否共享整个文档(带有 logicalSurface 值为 truebrowser),还是只共享文档的当前可见部分(其中 browser 表面的 logicalSurfacefalse)。

规范

规范
屏幕捕获
# dom-mediatrackconstraintset-logicalsurface

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅