MediaTrackConstraints: 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 Januar 2020.
Das MediaTrackConstraints-Wörterbuch enthält die echoCancellation-Eigenschaft, die ein ConstrainBooleanOrDOMString beschreibt. Diese Eigenschaft legt die angeforderten oder zwingenden Einschränkungen für den Wert der echoCancellation einschränkbaren Eigenschaft fest.
Falls nötig, 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. In der Regel ist dies jedoch nicht erforderlich, da Browser unbekannte Einschränkungen ignorieren.
Wert
Ein Boolean, ein String oder ein ConstrainBooleanOrDOMString-Objekt.
Wenn der Browser bestimmte Arten der Echounterdrückung unterstützt, kann der Wert auf eine der folgenden Möglichkeiten gesetzt werden:
"all"-
Alle vom Benutzer generierten System-Audiodaten, die durch das Mikrofon des Benutzers erfasst werden, werden entfernt. Dies ist beispielsweise nützlich in Situationen, in denen Sie vermeiden möchten, datenschutzsensible Audiodaten wie Screenreader-Ausgaben und Systembenachrichtigungen zu erfassen.
"remote-only"-
Nur Audiodaten, die von entfernten Quellen durch das Mikrofon des Benutzers erfasst werden (wie sie von
MediaStreamTracks dargestellt werden, die von einerRTCPeerConnectionstammen), werden entfernt. Dies ist nützlich, wenn Sie Echo aus der Kommunikation mit entfernten Partnern entfernen möchten, jedoch lokale Audiodaten weiterhin teilen möchten. Zum Beispiel in einem Musikunterricht, in dem der Lehrer seine Schüler zu einem Audiotrack mitspielen hören möchte, aber dennoch klar mit ihnen kommunizieren möchte. true-
Der Browser entscheidet, welches Audio von den durch das Mikrofon aufgezeichneten Signalen entfernt wird. Er muss versuchen, mindestens so viel wie
remote-onlyzu unterdrücken und sollte versuchen, so viel wieallzu unterdrücken. false-
Kein Audio wird entfernt; es erfolgt keine Echounterdrückung.
Falls der Browser keine speziellen Arten der Echounterdrückung unterstützt, kann der Wert true oder false sein.
Wenn der Wert auf einen der obigen Werte gesetzt ist, wird der Benutzeragent versuchen, Medien mit aktivierter oder deaktivierter Echounterdrückung wie angegeben zu erhalten, wenn möglich. Ein Fehlschlag tritt nicht ein, wenn dies nicht erreicht werden kann.
Wenn der Wert als Objekt mit einem exact-Feld angegeben wird, gibt der Wert dieses Felds eine erforderliche Einstellung für die Echounterdrückungsfunktion an; wenn dies nicht erfüllt werden kann, führt die Anfrage zu einem Fehler.
Beispiele
Siehe das Beispiel des Constraints-Übungstools.
Spezifikationen
| Specification |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-echocancellation |
Browser-Kompatibilität
Loading…