MediaTrackConstraints: 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 Dictionaries MediaTrackConstraints ist ein ConstrainDOMString, der die gewünschten oder zwingenden Einschränkungen für den Wert der einschränkbaren Eigenschaft facingMode beschreibt.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von facingMode untersuchen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. Normalerweise ist das jedoch nicht erforderlich, da Browser ihnen unbekannte Einschränkungen ignorieren.
Da RTP diese Information nicht enthält, weisen Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, diese Eigenschaft niemals auf.
Wert
Ein auf ConstrainDOMString basierendes Objekt, das einen oder mehrere zulässige, bevorzugte und/oder exakte (zwingend erforderliche) Werte für die Ausrichtung einer Videospur angibt.
Ein exact-Wert bedeutet hier, dass die angegebene Ausrichtung zwingend erforderlich ist. Zum Beispiel:
const constraints = {
facingMode: { exact: "user" },
};
Dies bedeutet, dass nur eine zum Benutzer gerichtete Kamera zulässig ist. Wenn eine solche Kamera nicht vorhanden ist oder der Benutzer die Berechtigung zu ihrer Verwendung verweigert, schlägt die Medienanfrage fehl.
Die folgenden Strings sind als Werte für die Ausrichtung zulässig. Sie können unterschiedliche Kameras oder Richtungen bezeichnen, in die eine verstellbare Kamera ausgerichtet werden kann.
"user"-
Die Videoquelle ist auf den Benutzer gerichtet. Dazu gehört beispielsweise die Frontkamera eines Smartphones.
"environment"-
Die Videoquelle ist vom Benutzer weg auf dessen Umgebung gerichtet. Dies ist die rückseitige Kamera eines Smartphones.
"left"-
Die Videoquelle ist auf den Benutzer gerichtet, befindet sich aber links von ihm, beispielsweise eine Kamera, die über seine linke Schulter hinweg auf ihn ausgerichtet ist.
"right"-
Die Videoquelle ist auf den Benutzer gerichtet, befindet sich aber rechts von ihm, beispielsweise eine Kamera, die über seine rechte Schulter hinweg auf ihn ausgerichtet ist.
Beispiele
Sehen Sie sich das Beispiel zum Ausprobieren von Einschränkungen an.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-facingmode |