MediaTrackConstraints:suppressLocalAudioPlayback 属性

可用性有限

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

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

MediaTrackConstraints 字典的 suppressLocalAudioPlayback 属性是一个 ConstrainBoolean,用于描述应用于 suppressLocalAudioPlayback 可约束属性值请求或强制约束。此属性控制在捕获选项卡时,选项卡中播放的音频是否会继续通过用户的本地扬声器播放。

如果需要,您可以通过检查 MediaDevices.getSupportedConstraints() 调用返回的 MediaTrackSupportedConstraints.suppressLocalAudioPlayback 的值来确定此约束是否受支持。但是,通常这并不必要,因为浏览器会忽略它们不熟悉的任何约束。

一个 ConstrainBoolean 值。

如果此值为简单的 truefalse,则用户代理将尝试在可能的情况下启用或禁用指定的本地音频播放来获取媒体,但如果无法做到这一点,也不会失败。

如果该值指定为 ideal,则该字段的布尔值表示本地音频播放抑制功能的理想设置;如果无法满足,则请求将导致错误。

示例

js
let isLocalAudioSuppressed = displayStream
  .getVideoTracks()[0]
  .getSettings().suppressLocalAudioPlayback;

约束执行器》示例展示了如何使用媒体轨道约束。

规范

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

浏览器兼容性

另见