MediaTrackSettings: facingMode 属性

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本使用。自 2017 年 9 月以来,它已在浏览器中提供。

MediaTrackSettings 字典的 facingMode 属性是一个字符串,表示生成 MediaStreamTrack 所代表的视频轨道的摄像头当前朝向的方向。这让您能够确定在调用 getUserMedia()MediaStreamTrack.applyConstraints() 时,为了满足您为该属性值指定的约束而选择的值,具体请参见 MediaTrackConstraints.facingMode 属性。

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

由于 RTP 不包含此信息,因此与 WebRTC RTCPeerConnection 关联的轨道永远不会包含此属性。

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

VideoFacingModeEnum

允许使用的 facing mode 的字符串值如下。这些值可能代表独立的摄像头,也可能代表一个可调焦摄像头的指向方向。

"user"

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

"environment"

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

"left"

视频源朝向用户但偏左,例如一个摄像头指向用户但从其左肩上方拍摄。

视频源朝向用户但偏右,例如一个摄像头指向用户但从其右肩上方拍摄。

示例

请参阅 Constraint exerciser 示例。

规范

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

浏览器兼容性

另见