MediaTrackConstraints: latency-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die latency-Eigenschaft des MediaTrackConstraints-Dictionarys ist ein ConstrainDouble, der die gewünschten oder zwingenden Vorgaben für den Wert der einschränkbaren Eigenschaft latency beschreibt.
Bei Bedarf können Sie prüfen, ob diese Vorgabe unterstützt wird, indem Sie den Wert von latency überprüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist dies jedoch nicht nötig, da Browser ihnen unbekannte Vorgaben ignorieren.
Da RTP diese Information nicht enthält, weisen Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, diese Eigenschaft nie auf.
Wert
Ein ConstrainDouble, der den zulässigen oder erforderlichen Wert beziehungsweise Werte für die Latenz eines Audio-Tracks beschreibt, angegeben in Sekunden. Bei der Audioverarbeitung ist die Latenz die Zeit zwischen dem Beginn der Verarbeitung (wenn ein Ton in der realen Welt entsteht oder von einem Hardwaregerät erzeugt wird) und dem Zeitpunkt, zu dem die Daten für den nächsten Schritt der Audioeingabe oder -ausgabe verfügbar sind. In den meisten Fällen ist eine niedrige Latenz für die Leistung und die Benutzererfahrung wünschenswert. Wenn jedoch der Stromverbrauch eine Rolle spielt oder Verzögerungen anderweitig akzeptabel sind, kann auch eine höhere Latenz akzeptabel sein.
Ist der Wert dieser Eigenschaft eine Zahl, versucht der User Agent, Medien zu erhalten, deren Latenz unter Berücksichtigung der Hardwarefähigkeiten und der anderen angegebenen Vorgaben möglichst nahe an dieser Zahl liegt. Andernfalls dient der Wert dieses ConstrainDouble dem User Agent als Grundlage, um die erforderliche Latenz exakt zu erreichen (wenn exact angegeben ist oder wenn sowohl min als auch max angegeben sind und denselben Wert haben) oder den bestmöglichen Wert zu erzielen.
Hinweis: Die Latenz unterliegt aufgrund der Hardwareauslastung, Netzwerkbedingungen und anderer Faktoren immer gewissen Schwankungen. Daher sind auch bei einer „exakten“ Übereinstimmung Abweichungen zu erwarten.
Beispiele
Sehen Sie sich das Beispiel zum Testen von Vorgaben an.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-latency |