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 MediaTrackConstraints-Dictionaries 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. Überprüfen Sie dazu den Wert von facingMode, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist dies 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 facingMode eines Videotracks angibt.
Ein exact-Wert bedeutet in diesem Fall, dass der angegebene Wert für facingMode zwingend erforderlich ist. Zum Beispiel:
const constraints = {
facingMode: { exact: "user" },
};
Dies bedeutet, dass nur eine zum Benutzer gerichtete Kamera zulässig ist. Ist keine solche Kamera vorhanden oder verweigert der Benutzer die Berechtigung zu ihrer Verwendung, schlägt die Medienanfrage fehl.
Die folgenden Zeichenfolgen sind als Werte für facingMode zulässig. Sie können unterschiedliche Kameras oder Richtungen bezeichnen, in die eine verstellbare Kamera ausgerichtet werden kann.
"user"-
Die Videoquelle ist zum Benutzer gerichtet. Dazu gehört beispielsweise die Frontkamera eines Smartphones.
"environment"-
Die Videoquelle ist vom Benutzer weggerichtet und erfasst dessen Umgebung. Dies entspricht der Rückkamera eines Smartphones.
"left"-
Die Videoquelle ist zum Benutzer gerichtet, befindet sich aber zu dessen Linken, beispielsweise eine Kamera, die über die linke Schulter des Benutzers hinweg auf ihn gerichtet ist.
"right"-
Die Videoquelle ist zum Benutzer gerichtet, befindet sich aber zu dessen Rechten, beispielsweise eine Kamera, die über die rechte Schulter des Benutzers hinweg auf ihn gerichtet ist.
Beispiele
Siehe das Beispiel zum Testen von Einschränkungen.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-facingmode |