このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

MediaTrackConstraints: facingMode プロパティ

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。

MediaTrackConstraints 辞書の facingMode プロパティは、要求または必須の制約を記述する ConstrainDOMString で、制約可能プロパティ facingMode の値に適用されます。

必要であれば、この制約に対応しているかどうかを、facingMode の値を確認することで判断できます。 この値は MediaDevices.getSupportedConstraints() の呼び出しで返されます。 ただし、ブラウザーは通常、認識できない制約を無視するため、この確認は不要です。

RTP にはこの情報が含まれていないため、WebRTC の RTCPeerConnection に関連付けられているトラックには、このプロパティは含まれません。

値

ConstrainDOMString に基づくオブジェクトで、動画トラックに受け入れ可能な向きを 1 つ以上指定します。 これらは、受け入れ可能、理想的、または必須 (exact) の値です。

この場合、exact 値は指定された向きが必須であることを示します。 例えば、次のようになります。

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

これは、ユーザーに面したカメラ(自撮りカメラ)だけが受け入れ可能であることを示します。 そのようなカメラがない場合、またはユーザーがそのカメラの使用許可を拒否した場合、メディアリクエストは失敗します。

向きの値として許可されている文字列は次のとおりです。 これらは、別々のカメラを表す場合も、向きを調整できるカメラを向ける方向を表す場合もあります。

"user"

映像ソースはユーザーの方を向いています。例えば、スマートフォンの前面カメラがこれに該当します。

"environment"

映像ソースはユーザーから離れる方向を向き、周囲の環境を映します。 これはスマートフォンの背面カメラです。

"left"

映像ソースはユーザーの方を向いていますが、ユーザーから見て左側に向いています。 例えば、ユーザーの左肩越しにユーザーへ向けたカメラなどです。

映像ソースはユーザーの方を向いていますが、ユーザーから見て右側に向いています。 例えば、ユーザーの右肩越しにユーザーへ向けたカメラなどです。

例

制約エクササイザーの例を参照してください。

仕様書

仕様書
Media Capture and Streams
# dom-mediatrackconstraintset-facingmode

ブラウザーの互換性

関連情報