MediaTrackSettings: autoGainControl-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die Eigenschaft autoGainControl des Dictionaries MediaTrackSettings ist ein boolescher Wert. Er gibt an, ob die automatische Verstärkungsregelung (Automatic Gain Control, AGC) für eine Audiospur aktiviert ist. So können Sie feststellen, welcher Wert gewählt wurde, um die von Ihnen festgelegten Constraints für diese Eigenschaft einzuhalten. Diese Constraints haben Sie über die Eigenschaft MediaTrackConstraints.autoGainControl beim Aufruf von getUserMedia() oder MediaStreamTrack.applyConstraints() angegeben.
Die automatische Verstärkungsregelung ist eine Funktion, bei der Änderungen der Lautstärke eines Audioeingangssignals automatisch ausgeglichen werden, um eine gleichmäßige Gesamtlautstärke zu erhalten. Sie wird üblicherweise bei Mikrofonen eingesetzt, kann aber auch von anderen Eingabequellen bereitgestellt werden.
Bei Bedarf können Sie prüfen, ob dieses Constraint unterstützt wird. Sehen Sie dazu nach, welchen Wert autoGainControl bei einem Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. Normalerweise ist das jedoch nicht nötig, da Browser unbekannte Constraints ignorieren.
Wert
Ein boolescher Wert, der true ist, wenn die automatische Verstärkungsregelung für die Spur aktiviert ist, oder false, wenn AGC deaktiviert ist.
Beispiele
Siehe das Beispiel zum Testen von Constraints.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams> # dom-mediatrackconstraintset-autogaincontrol> |