MediaTrackSettings: logicalSurface 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

MediaTrackSettings 字典的 logicalSurface 属性指示正在捕获的显示区域是否为逻辑表面。逻辑表面是指不一定完全在屏幕上,甚至可能在屏幕外的表面,例如窗口的后备缓冲区(其中缓冲区的一部分在不滚动包含窗口的情况下是可见的)和屏幕外渲染上下文。

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

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

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

例如,用户代理可以选择允许用户选择是共享整个文档(一个 browserlogicalSurface 值为 true),还是仅共享文档当前可见的部分(其中 browser 表面的 logicalSurfacefalse)。

规范

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

浏览器兼容性

另见