MediaTrackSettings: echoCancellation-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Die echoCancellation-Eigenschaft des MediaTrackSettings-Wörterbuchs ist ein Boolescher Wert, der angibt, ob Echo-Unterdrückung auf einer Audiospur aktiviert ist. Dies lässt Sie feststellen, welcher Wert ausgewählt wurde, um Ihre angegebenen Einschränkungen für den Wert dieser Eigenschaft zu erfüllen, wie im MediaTrackConstraints.echoCancellation beschriebenen Parameter, den Sie bei Aufrufen von entweder getUserMedia() oder MediaStreamTrack.applyConstraints() angegeben haben.

Echo-Unterdrückung ist eine Funktion, die versucht, Echo-Effekte in einer bidirektionalen Audioverbindung zu verhindern, indem sie versucht, das Übersprechen zwischen dem Ausgabegerät des Benutzers und dem Eingabegerät zu reduzieren oder zu eliminieren. Beispielsweise könnte sie einen Filter anwenden, der das auf den Lautsprechern erzeugte Geräusch negiert, damit es nicht in die vom Mikrofon erzeugte Eingabespur aufgenommen wird.

Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.echoCancellation überprüfen, der durch einen Aufruf von MediaDevices.getSupportedConstraints() zurückgegeben wird. Typischerweise ist dies jedoch unnötig, da Browser alle ihnen unbekannten Einschränkungen ignorieren.

Da RTP diese Information nicht einschließt, werden Spuren, die mit einem WebRTC RTCPeerConnection assoziiert sind, diese Eigenschaft niemals enthalten.

Wert

Ein Boolescher Wert, der true ist, wenn die Spur Echo-Unterdrückungsfunktionen aktiviert hat, oder false, wenn die Echo-Unterdrückung deaktiviert ist.

Beispiele

Siehe das Constraint exerciser-Beispiel.

Spezifikationen

Specification
Media Capture and Streams
# dom-mediatrackconstraintset-echocancellation

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
echoCancellation constraint

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch