MediaTrackConstraints: suppressLocalAudioPlayback 属性

实验性： 这是一个 实验性技术
在生产环境中使用此功能之前，请仔细查看 浏览器兼容性表。

MediaTrackConstraints 字典的 suppressLocalAudioPlayback 属性是一个 ConstrainBoolean，描述了对 suppressLocalAudioPlayback 可约束属性的值施加的请求或强制约束。此属性控制在捕获选项卡时，选项卡中播放的音频是否继续从用户的本地扬声器播放。

如果需要，可以通过检查 MediaTrackSupportedConstraints.suppressLocalAudioPlayback 的值来确定此约束是否受支持，该值由对 MediaDevices.getSupportedConstraints() 的调用返回。但是，通常情况下，这并非必要，因为浏览器会忽略任何不认识的约束。

值

一个 ConstrainBoolean 值。

如果此值是简单的 true 或 false，则用户代理将尝试获取具有本地音频播放功能的媒体，如果可能，则按指定启用或禁用，但如果无法完成，则不会失败。

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

示例

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

约束练习器 示例演示了如何使用媒体轨迹约束。

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅