MediaTrackSettings: echoCancellation 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

MediaTrackSettings 字典的 echoCancellation 属性是一个布尔值,其值指示音频轨道上是否启用了回声消除。这可以帮助您确定在调用 getUserMedia()MediaStreamTrack.applyConstraints() 时,为了满足您为该属性值提供的 MediaTrackConstraints.echoCancellation 约束而选择的值。

回声消除是一项功能,它通过尝试减少或消除用户输出设备与其输入设备之间的串扰,来防止双向音频连接中的回声效果。例如,它可能会应用一个过滤器,该过滤器会抵消扬声器发出的声音被麦克风生成的输入轨道包含的情况。

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

由于 RTP 不包含此信息,因此与 WebRTC RTCPeerConnection 关联的轨道永远不会包含此属性。

一个布尔值,如果轨道启用了回声消除功能,则为 true,如果禁用了回声消除,则为 false

示例

请参阅 Constraint exerciser 示例。

规范

规范
媒体捕获和流
# dom-mediatrackconstraintset-echocancellation

浏览器兼容性

另见