MediaTrackSettings: facingMode-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Eigenschaft facingMode des MediaTrackSettings-Dictionarys ist ein String, der angibt, in welche Richtung die Kamera derzeit ausgerichtet ist, die den durch den MediaStreamTrack repräsentierten Videotrack erzeugt. So können Sie feststellen, welcher Wert ausgewählt wurde, um die von Ihnen festgelegten Vorgaben für diese Eigenschaft zu erfüllen. Diese Vorgaben werden durch die Eigenschaft MediaTrackConstraints.facingMode beschrieben, die Sie beim Aufruf von getUserMedia() oder MediaStreamTrack.applyConstraints() angegeben haben.
Bei Bedarf können Sie prüfen, ob diese Vorgabe unterstützt wird, indem Sie den Wert von facingMode überprüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. Normalerweise ist dies jedoch nicht erforderlich, da Browser ihnen unbekannte Vorgaben ignorieren.
Da RTP diese Information nicht enthält, ist diese Eigenschaft bei Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, niemals enthalten.
Wert
Ein String, dessen Wert einer der unter VideoFacingModeEnum aufgeführten Strings ist.
VideoFacingModeEnum
Die folgenden Strings sind zulässige Werte für die Ausrichtung. Sie können unterschiedliche Kameras bezeichnen oder Richtungen, in die eine verstellbare Kamera ausgerichtet werden kann.
"user"-
Die Videoquelle ist auf die nutzende Person gerichtet. Dazu gehört beispielsweise die Frontkamera eines Smartphones.
"environment"-
Die Videoquelle ist von der nutzenden Person weg auf deren Umgebung gerichtet. Bei einem Smartphone ist dies die Rückkamera.
"left"-
Die Videoquelle ist auf die nutzende Person gerichtet, befindet sich aber links von ihr, beispielsweise eine Kamera, die über ihre linke Schulter hinweg auf sie gerichtet ist.
"right"-
Die Videoquelle ist auf die nutzende Person gerichtet, befindet sich aber rechts von ihr, beispielsweise eine Kamera, die über ihre rechte Schulter hinweg auf sie gerichtet ist.
Beispiele
Siehe das Beispiel zum Testen von Vorgaben.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-facingmode |