MediaTrackSupportedConstraintsディクショナリは、MediaStreamTrackオブジェクトを実装しているuser agentやブラウザによって理解できる制約可能なプロパティの一覧を表します。MediaDevices.getSupportedConstraints()によって、MediaTrackSupportedConstraintsに適合するオブジェクトが戻り値として返されます。
WebIDLでのインタフェース定義の手順で動作するため、制約は受け付けられたがサポートしていない場合エラーは発生しません。代わりに、指定された制約は解釈できなかった制約を除いて適用されるでしょう。これは混乱を招きエラーのデバッグを困難にするので、制約が暗黙的に無視されたのか制約が受け付けられたのかを知りたい場合は、getSupportedConstraints()を用いて、制約の確立を試みる前にこの情報を取得してください。
実際の制約セットはMediaTrackConstraintsディクショナリをベースにしたオブジェクトで表現されます。
制約がどのように動作するかについての詳細を知りたい場合は、Capabilities, constraints, and settingsを読んでください。
プロパティ
オブジェクトは以下のプロパティの組み合わせであり、必ずしも全てのプロパティが含まれるわけではありません。
autoGainControl- 実行環境で
autoGainControl制約がサポートされている場合は、Boolean型のtrueの値になります。 width- 実行環境で
width制約がサポートされている場合は、Boolean型のtrueの値になります。 height- 実行環境で
height制約がサポートされている場合は、Boolean型のtrueの値になります。 aspectRatio- 実行環境で
aspectRatio制約がサポートされている場合は、Boolean型のtrueの値になります。 frameRate- 実行環境で
frameRate制約がサポートされている場合は、Boolean型のtrueの値になります。 facingMode- 実行環境で
facingMode制約がサポートされている場合は、Boolean型のtrueの値になります。 volume- 実行環境で
volume制約がサポートされている場合は、Boolean型のtrueの値になります。 sampleRate- 実行環境で
sampleRate制約がサポートされている場合は、Boolean型のtrueの値になります。 sampleSize- 実行環境で
sampleSize制約がサポートされている場合は、Boolean型のtrueの値になります。 echoCancellation- 実行環境で
echoCancellation制約がサポートされている場合は、Boolean型のtrueの値になります。 latency- 実行環境で
latency制約がサポートされている場合は、Boolean型のtrueの値になります。 noiseSuppression- 実行環境で
noiseSuppression制約がサポートされている場合は、Boolean型のtrueの値になります。 channelCount- 実行環境で
channelCount制約がサポートされている場合は、Boolean型のtrueの値になります。 deviceId- 実行環境で
deviceId制約がサポートされている場合は、Boolean型のtrueの値になります。 groupId- 実行環境で
groupId制約がサポートされている場合は、Boolean型のtrueの値になります。