MediaTrackSupportedConstraints

Das MediaTrackSupportedConstraints Wörterbuch legt die Liste der einschränkbaren Eigenschaften fest, 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 Funktionsweise von Schnittstellendefinitionen in WebIDL wird kein Fehler auftreten, wenn eine Einschränkung angefordert, aber nicht unterstützt wird. Stattdessen werden die spezifizierten Einschränkungen angewendet, wobei alle nicht erkannten Einschränkungen aus der Anfrage entfernt werden. Dies kann zu verwirrenden und schwer nachvollziehbaren Fehlern führen. Verwenden Sie daher getSupportedConstraints(), 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ächliches 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, siehe Capabilities, constraints, and settings.

Instanzeigenschaften

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

autoGainControl

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

width

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

height

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

aspectRatio

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

frameRate

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

facingMode

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

resizeMode

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

volume

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

sampleRate

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

sampleSize

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

echoCancellation

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

latency

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

noiseSuppression

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

suppressLocalAudioPlayback

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

channelCount

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

deviceId

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

groupId

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

Instanzeigenschaften, die für freigegebene Bildschirmspuren spezifisch sind

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

displaySurface

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

logicalSurface

Ein Boolean-Wert, 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