MediaTrackSettings:facingMode 属性
MediaTrackSettings
字典的 facingMode
属性是一个字符串,指示由 MediaStreamTrack
表示的视频轨道的摄像头当前所朝的方向。这使您可以确定选择哪个值以符合您为此属性值指定的约束,如您在调用 getUserMedia()
或 MediaStreamTrack.applyConstraints()
时提供的 MediaTrackConstraints.facingMode
属性中所述。
如果需要,您可以通过检查 MediaTrackSupportedConstraints.facingMode
的值来确定此约束是否受支持,该值由对 MediaDevices.getSupportedConstraints()
的调用返回。但是,通常情况下,这没有必要,因为浏览器会忽略任何他们不熟悉的约束。
因为 RTP 不包含此信息,所以与 WebRTC RTCPeerConnection
关联的轨道将永远不会包含此属性。
值
一个字符串,其值为 VideoFacingModeEnum
中的字符串之一。
VideoFacingModeEnum
以下字符串是允许的面向模式值。这些可能代表单独的摄像头,或者可能代表可调节摄像头可以指向的方向。
"user"
-
视频源面向用户;这包括例如智能手机上的前置摄像头。
"environment"
-
视频源背对用户,从而查看其环境。这是智能手机的后置摄像头。
"left"
-
视频源面向用户,但位于其左侧,例如一个摄像头对准用户,但位于其左肩上方。
"right"
-
视频源面向用户,但位于其右侧,例如一个摄像头对准用户,但位于其右肩上方。
示例
请参阅 约束练习器 示例。
规范
规范 |
---|
媒体捕获和流 # dom-mediatrackconstraintset-facingmode |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。