The {{domxref("MediaTrackSettings")}} dictionary's facingMode
property is a {{domxref("DOMString")}} indicating the direction in which the camera producing the video track represented by the {{domxref("MediaStreamTrack")}} is currently facing. This lets you determine what value was selected to comply with your specified constraints for this property's value as described in the {{domxref("MediaTrackConstraints.facingMode")}} property you provided when calling either {{domxref("MediaDevices.getUserMedia", "getUserMedia()")}} or {{domxref("MediaStreamTrack.applyConstraints()")}}.
If needed, you can determine whether or not this constraint is supported by checking the value of {{domxref("MediaTrackSupportedConstraints.facingMode")}} as returned by a call to {{domxref("MediaDevices.getSupportedConstraints()")}}. However, typically this is unnecessary since browsers will simply ignore any constraints they're unfamiliar with.
Syntax
var facingMode = MediaTrackSettings.facingMode;
Value
A {{domxref("DOMString")}} whose value is one of the strings in {{anch("VideoFacingModeEnum")}}
.
VideoFacingModeEnum
The following strings are permitted values for the facing mode. These may represent separate cameras, or they may represent directions in which an adjustable camera can be pointed.
"user"
- The video source is facing toward the user; this includes, for example, the front-facing camera on a smartphone.
"environment"
- The video source is facing away from the user, thereby viewing their environment. This is the back camera on a smartphone.
"left"
- The video source is facing toward the user but to their left, such as a camera aimed toward the user but over their left shoulder.
"right"
- The video source is facing toward the user but to their right, such as a camera aimed toward the user but over their right shoulder.
Example
See {{SectionOnPage("/en-US/docs/Web/API/Media_Streams_API/Constraints", "Example: Constraint exerciser")}} for an example.
Specifications
Specification | Status | Comment |
---|---|---|
{{ SpecName('Media Capture', '#widl-MediaTrackSettings-facingMode', 'facingMode') }} | {{ Spec2('Media Capture') }} | Initial specification. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoDesktop(36)}} | {{CompatNo}} | {{CompatVersionUnknown}} | {{CompatUnknown}} |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile(36)}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatVersionUnknown}} |
See also
- Media Capture and Streams API
- Capabilities, constraints, and settings
- {{domxref("MediaTrackConstraints.facingMode")}}
- {{domxref("MediaTrackSettings")}}