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

瀏覽器相容性

另見