MediaTrackConstraints: volume-Eigenschaft
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Das volume-Eigenschaft des MediaTrackConstraints-Wörterbuchs ist ein ConstrainDouble, das die gewünschten oder zwingend erforderlichen Einschränkungen beschreibt, die auf den Wert der volume einschränkbaren Eigenschaft angewendet werden.
Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.volume überprüfen, der durch einen Aufruf von MediaDevices.getSupportedConstraints() zurückgegeben wird. Normalerweise ist dies jedoch nicht notwendig, da Browser unbekannte Einschränkungen ignorieren.
Wert
Ein ConstrainDouble, das den akzeptablen oder erforderlichen Wert für die Lautstärke einer Audio-Spur beschreibt, auf einer linearen Skala, bei der 0.0 Stille bedeutet und 1.0 die höchste unterstützte Lautstärke ist.
Wenn dieser Wert eine Zahl ist, wird die Benutzerumgebung versuchen, Medien zu erhalten, deren Lautstärke unter Berücksichtigung der Hardwarefähigkeiten und der anderen angegebenen Einschränkungen möglichst nah an dieser Zahl liegt. Andernfalls wird der Wert dieses ConstrainDouble die Benutzerumgebung bei ihren Bemühungen leiten, eine genaue Übereinstimmung mit der erforderlichen Lautstärke zu liefern (falls exact angegeben ist oder sowohl min als auch max bereitgestellt werden und denselben Wert haben) oder einen bestmöglichen Wert.
Jedes Einschränkungsset, das nur Werte außerhalb des Bereichs von 0.0 bis 1.0 erlaubt, kann nicht erfüllt werden und führt zu einem Fehler.
Beispiele
Siehe das Beispiel Constraint Exerciser.