大网数据广告活动
Web 标准与前端开发

MediaTrackConstraints: restrictOwnAudio property

· 52CE 我爱测

The MediaTrackConstraints dictionary's **`restrictOwnAudio`** property is a `ConstrainBoolean` that specifies the requested or mandatory constraints placed on the value of the `restrictOwnAudio` constrainable property.

Media Capture and Streams

The MediaTrackConstraints dictionary's restrictOwnAudio property is a ConstrainBoolean that specifies the requested or mandatory constraints placed on the value of the restrictOwnAudio constrainable property.

This property controls whether system audio originating from the capturing tab is filtered out of screen capture, allowing for cleaner screen recordings in some cases. For example, if the capturing web page itself is playing embedded audio or video, that audio would be included in the capture. Since this could lead to an undesirable echo or interfere with the intended audio sources from other tabs or applications, removing it from the capture is desirable.

If needed, you can determine whether or not this constraint is supported by checking the value of restrictOwnAudio, as returned by MediaDevices.getSupportedConstraints(). However, this is rarely necessary since browsers typically ignore any constraints they don't recognize.

Value

A ConstrainBoolean value.

If the value is true, the user agent will attempt to remove any audio originating from the tab that called MediaDevices.getDisplayMedia() to initiate screen capture. If removal of audio via processing fails, the user agent may exclude all audio originating from the capturing tab.

[!NOTE] If the captured display surface doesn't include system audio, this setting will have no effect.

If the value is given as exact, that field's boolean value indicates an exact requirement for the restrictOwnAudio feature; if the user agent can't meet this requirement, the request will result in an error.

If the value is false, the user agent will not attempt to restrict any system audio originating from the capturing tab.

Examples

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

The Constraint exerciser example shows how to use media track constraints.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。