MediaTrackConstraints: facingMode 屬性

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來,它已在瀏覽器中提供。

MediaTrackConstraints 字典的 facingMode 屬性是一個 ConstrainDOMString,描述了對 facingMode 可約束屬性值的請求或強制約束。

如果需要,您可以透過呼叫 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.facingMode 的值來確定是否支援此約束。但是,通常這是不必要的,因為瀏覽器會忽略它們不認識的任何約束。

由於 RTP 不包含此資訊,因此與 WebRTC RTCPeerConnection 關聯的軌道永遠不會包含此屬性。

一個基於 ConstrainDOMString 的物件,指定一個或多個可接受的、理想的以及/或精確的(強制性的)朝向模式,這些模式對於影片軌道是可接受的。

在這種情況下,exact 值表示明確要求指定的朝向模式;例如:

js
const constraints = {
  facingMode: { exact: "user" },
};

這表明只有面向使用者的攝像頭是可接受的;如果不存在面向使用者的攝像頭,或者使用者拒絕使用該攝像頭的許可權,則媒體請求將失敗。

以下字串是朝向模式允許的值。這些可能代表獨立的攝像頭,或者可能代表可調節攝像頭可以指向的方向。

"user"

影片源面向使用者;這包括,例如,智慧手機的前置攝像頭。

"environment"

影片源背離使用者,從而檢視其周圍環境。這是智慧手機的後置攝像頭。

"left"

影片源面向使用者但偏向其左側,例如,一個攝像頭對準使用者但位於其左肩上方。

影片源面向使用者但偏向其右側,例如,一個攝像頭對準使用者但位於其右肩上方。

示例

請參閱 Constraint exerciser 示例。

規範

規範
媒體捕獲和流
# dom-mediatrackconstraintset-facingmode

瀏覽器相容性

另見