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, ein ConstrainBooleanOrDOMString, das die angeforderten oder obligatorischen Einschränkungen beschreibt, die auf den Wert der echoCancellation-beschränkbaren Eigenschaft gesetzt werden.
Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.echoCancellation überprüfen, der von einem Aufruf von MediaDevices.getSupportedConstraints() zurückgegeben wird. Normalerweise ist dies jedoch nicht erforderlich, da Browser unbekannte Einschränkungen ignorieren.
Wert
Ein Boolean, ein String oder ein ConstrainBooleanOrDOMString-Objekt.
Wenn der Browser spezifische Echo-Kompensationstypen unterstützt, kann der Wert auf einen der folgenden Werte gesetzt werden:
"all"Experimentell-
Alle vom System des Nutzers generierten Audioinhalte, die vom Mikrofon des Nutzers erfasst werden, werden entfernt. Dies ist nützlich in Situationen, in denen Sie vermeiden möchten, datenschutzsensible Audioinhalte wie Bildschirmleser-Ausgaben und Systembenachrichtigungen zu erfassen.
"remote-only"Experimentell-
Nur vom System des Nutzers generierte Audioinhalte, die vom Mikrofon des Nutzers aus entfernten Quellen (wie durch
MediaStreamTracks aus einerRTCPeerConnection) erfasst werden, werden entfernt. Dies ist nützlich, wenn Sie Echo aus der Kommunikation mit entfernten Teilnehmern entfernen, aber dennoch lokale Audioinhalte teilen möchten, z. B. im Fall eines Musikunterrichts, bei dem der Lehrer die Schüler zu einem Audio-Track mitspielen lassen möchte, aber dennoch klar mit ihnen kommunizieren will. true-
Der Browser entscheidet, welche Audioinhalte von den Signalen, die vom Mikrofon aufgezeichnet werden, entfernt werden. Er muss versuchen, mindestens so viel wie
remote-onlyzu entfernen und sollte versuchen, so viel wieallzu entfernen. false-
Es wird kein Audio entfernt; es findet keine Echo-Kompensation statt.
Wenn der Browser keine spezifischen Echo-Kompensationstypen unterstützt, kann der Wert true oder false sein.
Wenn einer der oben genannten Werte gesetzt ist, versucht der Benutzeragent, Medien mit aktivierter oder deaktivierter Echo-Kompensation soweit möglich gemäß den Spezifikationen zu beziehen, schlägt jedoch nicht fehl, wenn dies nicht möglich ist.
Wenn der Wert als Objekt mit einem exact-Feld angegeben ist, gibt der Wert dieses Feldes eine obligatorische Einstellung für die Echo-Kompensation an; kann diese nicht erfüllt werden, führt dies zu einem Fehler.
Beispiele
Siehe das Beispiel Constraint Exerciser.
Spezifikationen
| Specification |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-echocancellation |
Browser-Kompatibilität
Loading…