MediaTrackSettings:facingMode 属性

MediaTrackSettings 字典的 facingMode 属性是一个字符串,指示由 MediaStreamTrack 表示的视频轨道的摄像头当前所朝的方向。这使您可以确定选择哪个值以符合您为此属性值指定的约束,如您在调用 getUserMedia()MediaStreamTrack.applyConstraints() 时提供的 MediaTrackConstraints.facingMode 属性中所述。

如果需要,您可以通过检查 MediaTrackSupportedConstraints.facingMode 的值来确定此约束是否受支持,该值由对 MediaDevices.getSupportedConstraints() 的调用返回。但是,通常情况下,这没有必要,因为浏览器会忽略任何他们不熟悉的约束。

因为 RTP 不包含此信息,所以与 WebRTC RTCPeerConnection 关联的轨道将永远不会包含此属性。

一个字符串,其值为 VideoFacingModeEnum 中的字符串之一。

VideoFacingModeEnum

以下字符串是允许的面向模式值。这些可能代表单独的摄像头,或者可能代表可调节摄像头可以指向的方向。

"user"

视频源面向用户;这包括例如智能手机上的前置摄像头。

"environment"

视频源背对用户,从而查看其环境。这是智能手机的后置摄像头。

"left"

视频源面向用户,但位于其左侧,例如一个摄像头对准用户,但位于其左肩上方。

视频源面向用户,但位于其右侧,例如一个摄像头对准用户,但位于其右肩上方。

示例

请参阅 约束练习器 示例。

规范

规范
媒体捕获和流
# dom-mediatrackconstraintset-facingmode

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅