MediaTrackSupportedConstraints：suppressLocalAudioPlayback 属性

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

MediaTrackSupportedConstraints 字典的 suppressLocalAudioPlayback 属性指示用户代理和使用内容的设备是否支持 suppressLocalAudioPlayback 约束。

支持的约束列表是通过调用 navigator.mediaDevices.getSupportedConstraints() 获得的。

值

如果设备和用户代理支持 suppressLocalAudioPlayback 约束，则为布尔值 true。

示例

下面的函数为对 getDisplayMedia() 的调用设置选项对象。它仅在已知浏览器支持的情况下添加 suppressLocalAudioPlayback 约束（请求不将捕获的音频播放到用户的本地扬声器）。然后通过调用 getDisplayMedia() 并将返回的流附加到变量 videoElem 引用的视频元素来启动捕获。

js
async function capture() {
  const supportedConstraints = navigator.mediaDevices.getSupportedConstraints();
  const displayMediaOptions = {
    audio: {},
  };

  if (supportedConstraints.suppressLocalAudioPlayback) {
    displayMediaOptions.audio.suppressLocalAudioPlayback = true;
  }

  try {
    videoElem.srcObject =
      await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
  } catch (err) {
    /* handle the error */
  }
}

规范

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

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅