MediaTrackSettings: 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 echoCancellation-Eigenschaft des MediaTrackSettings-Dictionary ist ein boolescher Wert, der angibt, ob die Echounterdrückung für einen Audiotrack aktiviert ist. Damit können Sie feststellen, welcher Wert ausgewählt wurde, um die von Ihnen festgelegten Constraints für diese Eigenschaft zu erfüllen. Diese Constraints geben Sie über die Eigenschaft MediaTrackConstraints.echoCancellation an, wenn Sie getUserMedia() oder MediaStreamTrack.applyConstraints() aufrufen.
Die Echounterdrückung versucht, Echos bei einer bidirektionalen Audioverbindung zu verhindern, indem sie Übersprechen zwischen dem Ausgabegerät und dem Eingabegerät der Benutzerin oder des Benutzers reduziert oder beseitigt. Beispielsweise kann ein Filter dafür sorgen, dass der von den Lautsprechern ausgegebene Ton nicht in den vom Mikrofon erzeugten Eingabetrack gelangt.
Bei Bedarf können Sie prüfen, ob dieses Constraint unterstützt wird, indem Sie den Wert von echoCancellation auswerten, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. Normalerweise ist das jedoch nicht nötig, da Browser unbekannte Constraints ignorieren.
Da RTP diese Information nicht enthält, weisen Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, diese Eigenschaft niemals auf.
Wert
Ein boolescher Wert, der true ist, wenn die Echounterdrückung für den Track aktiviert ist, oder false, wenn sie deaktiviert ist.
Beispiele
Siehe das Beispiel zum Ausprobieren von Constraints.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-echocancellation |