MediaTrackConstraints:restrictOwnAudio 属性

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

MediaTrackConstraints 字典的 restrictOwnAudio 属性是一个 ConstrainBoolean,用于指定对 restrictOwnAudio 可约束属性值所做的请求或强制约束。

此属性控制是否从屏幕捕获中过滤掉源自捕获标签的系统音频,以便在某些情况下获得更清晰的屏幕录制。例如,如果捕获的网页本身正在播放嵌入式音频或视频,该音频将被包含在捕获中。由于这可能会导致不期望的回声或干扰其他标签或应用程序的预期音频源,因此从捕获中删除它是可取的。

如果需要,可以通过检查 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.restrictOwnAudio 的值来确定此约束是否受支持。但是,这很少有必要,因为浏览器通常会忽略它们不识别的任何约束。

一个 ConstrainBoolean 值。

如果值为 true,则用户代理将尝试删除源自调用 MediaDevices.getDisplayMedia() 来启动屏幕捕获的标签的任何音频。如果通过处理无法删除音频,用户代理可能会排除源自捕获标签的所有音频。

注意:如果捕获的显示表面不包含系统音频,则此设置将无效。

如果值为 exact,则该字段的布尔值表示对 restrictOwnAudio 功能的严格要求;如果用户代理无法满足此要求,则请求将导致错误。

如果值为 false,则用户代理将不会尝试限制源自捕获标签的任何系统音频。

示例

js
let isCapturingTabSystemAudioRestricted = displayStream
  .getAudioTracks()[0]
  .getSettings().restrictOwnAudio;

Constraint exerciser 示例显示了如何使用媒体轨道约束。

规范

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

浏览器兼容性

另见