MediaTrackSupportedConstraints

Das MediaTrackSupportedConstraints Wörterbuch liefert die Liste der einschränkbaren Eigenschaften, die vom User-Agent oder Browser in seiner Implementierung des MediaStreamTrack-Objekts erkannt werden. Ein Objekt, das MediaTrackSupportedConstraints entspricht, wird von MediaDevices.getSupportedConstraints() zurückgegeben.

Aufgrund der Art und Weise, wie Schnittstellendefinitionen in WebIDL funktionieren, tritt kein Fehler auf, wenn eine Einschränkung angefordert wird, jedoch nicht unterstützt wird. Stattdessen werden die angegebenen Einschränkungen angewendet, wobei alle nicht erkannten Einschränkungen aus der Anfrage entfernt werden. Dies kann zu verwirrenden und schwer zu debuggen Fehlern führen. Stellen Sie daher sicher, dass Sie getSupportedConstraints() verwenden, um diese Informationen abzurufen, bevor Sie versuchen, Einschränkungen festzulegen, wenn Sie den Unterschied zwischen dem stillschweigenden Ignorieren einer Einschränkung und dem Akzeptieren einer Einschränkung kennen müssen.

Ein tatsächlicher Einschränkungssatz wird unter Verwendung eines Objekts beschrieben, das auf dem MediaTrackConstraints-Wörterbuch basiert.

Um mehr darüber zu erfahren, wie Einschränkungen funktionieren, sehen Sie sich Capabilities, constraints, and settings an.

Instanz-Eigenschaften

Eine Kombination - aber nicht unbedingt alle - der folgenden Eigenschaften wird auf dem Objekt existieren.

autoGainControl

Ein Boolean, dessen Wert true ist, wenn die autoGainControl-Einschränkung in der aktuellen Umgebung unterstützt wird.

width

Ein Boolean, dessen Wert true ist, wenn die width-Einschränkung in der aktuellen Umgebung unterstützt wird.

height

Ein Boolean, dessen Wert true ist, wenn die height-Einschränkung in der aktuellen Umgebung unterstützt wird.

aspectRatio

Ein Boolean, dessen Wert true ist, wenn die aspectRatio-Einschränkung in der aktuellen Umgebung unterstützt wird.

frameRate

Ein Boolean, dessen Wert true ist, wenn die frameRate-Einschränkung in der aktuellen Umgebung unterstützt wird.

facingMode

Ein Boolean, dessen Wert true ist, wenn die facingMode-Einschränkung in der aktuellen Umgebung unterstützt wird.

resizeMode

Ein Boolean, dessen Wert true ist, wenn die resizeMode-Einschränkung in der aktuellen Umgebung unterstützt wird.

volume

Ein Boolean, dessen Wert true ist, wenn die volume-Einschränkung in der aktuellen Umgebung unterstützt wird.

sampleRate

Ein Boolean, dessen Wert true ist, wenn die sampleRate-Einschränkung in der aktuellen Umgebung unterstützt wird.

sampleSize

Ein Boolean, dessen Wert true ist, wenn die sampleSize-Einschränkung in der aktuellen Umgebung unterstützt wird.

echoCancellation

Ein Boolean, dessen Wert true ist, wenn die echoCancellation-Einschränkung in der aktuellen Umgebung unterstützt wird.

latency

Ein Boolean, dessen Wert true ist, wenn die latency-Einschränkung in der aktuellen Umgebung unterstützt wird.

noiseSuppression

Ein Boolean, dessen Wert true ist, wenn die noiseSuppression-Einschränkung in der aktuellen Umgebung unterstützt wird.

channelCount

Ein Boolean, dessen Wert true ist, wenn die channelCount-Einschränkung in der aktuellen Umgebung unterstützt wird.

deviceId

Ein Boolean, dessen Wert true ist, wenn die deviceId-Einschränkung in der aktuellen Umgebung unterstützt wird.

groupId

Ein Boolean, dessen Wert true ist, wenn die groupId-Einschränkung in der aktuellen Umgebung unterstützt wird.

Instanz-Eigenschaften spezifisch für freigebene Bildschirmspuren

Für Spuren, die Videoquellen von Inhalten des Benutzerbildschirms enthalten, können zusätzlich zu denen, die für Videospuren verfügbar sind, die folgenden zusätzlichen Eigenschaften enthalten sein.

displaySurface

Ein Boolean, der true ist, wenn die displaySurface-Einschränkung in der aktuellen Umgebung unterstützt wird.

logicalSurface

Ein Boolean, der true ist, wenn die logicalSurface-Einschränkung in der aktuellen Umgebung unterstützt wird.

Spezifikationen

Specification
Media Capture and Streams
# media-track-supported-constraints

Siehe auch