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 Dictionaries MediaTrackConstraints 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 prüfen, 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 das 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 einen der folgenden Werte gesetzt werden:
"all"-
Sämtliche vom System erzeugten Audiosignale, die vom Mikrofon des Benutzers erfasst werden, werden entfernt. Das ist beispielsweise nützlich, wenn Sie vermeiden möchten, dass vertrauliche Audiosignale wie die Ausgabe eines Screenreaders oder Systembenachrichtigungen erfasst werden.
"remote-only"-
Nur vom System erzeugte Audiosignale aus entfernten Quellen, die vom Mikrofon des Benutzers erfasst werden, werden entfernt. Diese Quellen werden durch
MediaStreamTracks repräsentiert, die von einerRTCPeerConnectionstammen. Das ist nützlich, wenn Sie Echos bei der Kommunikation mit entfernten Gesprächspartnern entfernen, lokale Audiosignale aber 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 zugleich klar mit ihnen verständigen möchte. true-
Der Browser entscheidet, welche Audiosignale aus den vom Mikrofon aufgenommenen Signalen entfernt werden. Er muss versuchen, mindestens so viele Audiosignale zu unterdrücken wie bei
remote-only, 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 mit entsprechend aktivierter oder deaktivierter Echounterdrückung abzurufen, sofern dies möglich ist. Ist dies nicht möglich, schlägt die Anfrage jedoch nicht fehl.
Wird der Wert als Objekt mit einem exact-Feld angegeben, legt der Wert dieses Felds eine zwingend erforderliche 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-Tester.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-echocancellation |