MediaTrackConstraints: echoCancellation-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Die Eigenschaft echoCancellation des MediaTrackConstraints-Dictionaries ist ein ConstrainBooleanOrDOMString, der die gewünschten oder zwingenden Einschränkungen für den Wert der einschränkbaren Eigenschaft echoCancellation beschreibt.
Bei Bedarf können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von echoCancellation prüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist dies jedoch nicht nötig, da Browser ihnen unbekannte Einschränkungen ignorieren.
Wert
Ein boolescher Wert, ein String oder ein ConstrainBooleanOrDOMString-Objekt.
Wenn der Browser bestimmte Arten der Echounterdrückung unterstützt, kann der Wert auf eine der folgenden Optionen gesetzt werden:
"all"-
Sämtliche vom System des Benutzers erzeugten Audiosignale, die vom Mikrofon des Benutzers erfasst werden, werden entfernt. Dies ist beispielsweise nützlich, wenn Sie vermeiden möchten, dass datenschutzsensible Audiosignale wie die Ausgabe eines Screenreaders oder Systembenachrichtigungen erfasst werden.
"remote-only"-
Nur die vom System des Benutzers erzeugten Audiosignale aus entfernten Quellen, die vom Mikrofon des Benutzers erfasst werden, werden entfernt. Diese Quellen werden durch
MediaStreamTracks repräsentiert, die aus einerRTCPeerConnectionstammen. Dies ist nützlich, wenn Sie Echos bei der Kommunikation mit entfernten Teilnehmern unterdrücken, aber lokale Audiosignale weiterhin übertragen möchten – etwa bei einer Musikstunde, in der die Lehrkraft hören möchte, wie ihre Schüler zu einer Audiospur mitspielen, und sich trotzdem klar mit ihnen verständigen können soll. true-
Der Browser entscheidet, welche Audiosignale aus den vom Mikrofon aufgenommenen Signalen entfernt werden. Er muss versuchen, mindestens so viele Audiosignale wie bei
remote-onlyzu unterdrücken, und sollte versuchen, so viele wie beiallzu unterdrücken. false-
Es werden keine Audiosignale entfernt; es findet keine Echounterdrückung statt.
Wenn der Browser keine bestimmten Arten der Echounterdrückung unterstützt, kann der Wert true oder false sein.
Wird einer der oben genannten Werte festgelegt, versucht der User Agent, Medien wie angegeben mit aktivierter oder deaktivierter Echounterdrückung abzurufen, sofern dies möglich ist. Schlägt dies fehl, führt das jedoch nicht zu einem Fehler.
Wird der Wert als Objekt mit einem exact-Feld angegeben, legt der Wert dieses Felds eine zwingende Einstellung für die Echounterdrückung fest. Kann diese Anforderung nicht erfüllt werden, führt die Anfrage zu einem Fehler.
Beispiele
Siehe das Beispiel Constraint exerciser.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-echocancellation |