MediaTrackSupportedConstraints
Das MediaTrackSupportedConstraints Dictionary erstellt die Liste der einschränkbaren Eigenschaften, die vom Benutzeragenten oder Browser in seiner Implementierung des MediaStreamTrack Objekts erkannt werden. Ein Objekt, das dem MediaTrackSupportedConstraints entspricht, wird von MediaDevices.getSupportedConstraints() zurückgegeben.
Aufgrund der Funktionsweise von Schnittstellendefinitionen in WebIDL tritt kein Fehler auf, wenn eine Einschränkung angefordert, aber nicht unterstützt wird. Stattdessen werden die angegebenen Einschränkungen angewendet, wobei nicht erkannte Einschränkungen aus der Anforderung entfernt werden. Dies kann zu verwirrenden und schwer zu debuggen Fehlern führen. Daher sollten 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 der Annahme einer Einschränkung kennen müssen.
Ein tatsächliches Einschränkungsset wird unter Verwendung eines auf dem MediaTrackConstraints Dictionary basierenden Objekts beschrieben.
Um mehr darüber zu erfahren, wie Einschränkungen funktionieren, sehen Sie sich Fähigkeiten, Einschränkungen und Einstellungen an.
Instanz-Eigenschaften
Eine Kombination – aber nicht unbedingt alle – der folgenden Eigenschaften wird auf dem Objekt existieren.
autoGainControl-
Ein boolescher Wert, der
trueist, wenn dieautoGainControlEinschränkung in der aktuellen Umgebung unterstützt wird. width-
Ein boolescher Wert, der
trueist, wenn diewidthEinschränkung in der aktuellen Umgebung unterstützt wird. height-
Ein boolescher Wert, der
trueist, wenn dieheightEinschränkung in der aktuellen Umgebung unterstützt wird. aspectRatio-
Ein boolescher Wert, der
trueist, wenn dieaspectRatioEinschränkung in der aktuellen Umgebung unterstützt wird. frameRate-
Ein boolescher Wert, der
trueist, wenn dieframeRateEinschränkung in der aktuellen Umgebung unterstützt wird. facingMode-
Ein boolescher Wert, der
trueist, wenn diefacingModeEinschränkung in der aktuellen Umgebung unterstützt wird. resizeMode-
Ein boolescher Wert, der
trueist, wenn dieresizeModeEinschränkung in der aktuellen Umgebung unterstützt wird. volumeVeraltet Nicht standardisiert-
Ein boolescher Wert, der
trueist, wenn dievolumeEinschränkung in der aktuellen Umgebung unterstützt wird. sampleRate-
Ein boolescher Wert, der
trueist, wenn diesampleRateEinschränkung in der aktuellen Umgebung unterstützt wird. sampleSize-
Ein boolescher Wert, der
trueist, wenn diesampleSizeEinschränkung in der aktuellen Umgebung unterstützt wird. echoCancellation-
Ein boolescher Wert, der
trueist, wenn dieechoCancellationEinschränkung in der aktuellen Umgebung unterstützt wird. latency-
Ein boolescher Wert, der
trueist, wenn dielatencyEinschränkung in der aktuellen Umgebung unterstützt wird. noiseSuppression-
Ein boolescher Wert, der
trueist, wenn dienoiseSuppressionEinschränkung in der aktuellen Umgebung unterstützt wird. channelCount-
Ein boolescher Wert, der
trueist, wenn diechannelCountEinschränkung in der aktuellen Umgebung unterstützt wird. deviceId-
Ein boolescher Wert, der
trueist, wenn diedeviceIdEinschränkung in der aktuellen Umgebung unterstützt wird. groupId-
Ein boolescher Wert, der
trueist, wenn diegroupIdEinschränkung in der aktuellen Umgebung unterstützt wird.
Instanz-Eigenschaften spezifisch für geteilte Bildschirmspuren
Für Spuren, die Videoquellen aus den Bildschirm-Inhalten des Benutzers enthalten, können zusätzlich zu den für Videospuren verfügbaren Eigenschaften folgende zusätzliche Eigenschaften enthalten sein.
displaySurface-
Ein boolescher Wert, der
trueist, wenn diedisplaySurfaceEinschränkung in der aktuellen Umgebung unterstützt wird. logicalSurface-
Ein boolescher Wert, der
trueist, wenn dielogicalSurfaceEinschränkung in der aktuellen Umgebung unterstützt wird.
Spezifikationen
| Specification |
|---|
| Media Capture and Streams # media-track-supported-constraints |