MediaTrackConstraints: facingMode プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。
MediaTrackConstraints 辞書の facingMode プロパティは、要求または必須の制約を記述する ConstrainDOMString で、制約可能プロパティ facingMode の値に適用されます。
必要であれば、この制約に対応しているかどうかを、facingMode の値を確認することで判断できます。
この値は MediaDevices.getSupportedConstraints() の呼び出しで返されます。
ただし、ブラウザーは通常、認識できない制約を無視するため、この確認は不要です。
RTP にはこの情報が含まれていないため、WebRTC の RTCPeerConnection に関連付けられているトラックには、このプロパティは含まれません。
値
ConstrainDOMString に基づくオブジェクトで、動画トラックに受け入れ可能な向きを 1 つ以上指定します。
これらは、受け入れ可能、理想的、または必須 (exact) の値です。
この場合、exact 値は指定された向きが必須であることを示します。
例えば、次のようになります。
const constraints = {
facingMode: { exact: "user" },
};
これは、ユーザーに面したカメラ(自撮りカメラ)だけが受け入れ可能であることを示します。 そのようなカメラがない場合、またはユーザーがそのカメラの使用許可を拒否した場合、メディアリクエストは失敗します。
向きの値として許可されている文字列は次のとおりです。 これらは、別々のカメラを表す場合も、向きを調整できるカメラを向ける方向を表す場合もあります。
"user"-
映像ソースはユーザーの方を向いています。例えば、スマートフォンの前面カメラがこれに該当します。
"environment"-
映像ソースはユーザーから離れる方向を向き、周囲の環境を映します。 これはスマートフォンの背面カメラです。
"left"-
映像ソースはユーザーの方を向いていますが、ユーザーから見て左側に向いています。 例えば、ユーザーの左肩越しにユーザーへ向けたカメラなどです。
"right"-
映像ソースはユーザーの方を向いていますが、ユーザーから見て右側に向いています。 例えば、ユーザーの右肩越しにユーザーへ向けたカメラなどです。
例
制約エクササイザーの例を参照してください。
仕様書
| 仕様書 |
|---|
| Media Capture and Streams> # dom-mediatrackconstraintset-facingmode> |