MediaTrackSupportedConstraints

MediaTrackSupportedConstraintsディクショナリは、MediaStreamTrackオブジェクトを実装しているuser agentやブラウザによって理解できる制約可能なプロパティの一覧を表します。MediaDevices.getSupportedConstraints()によって、MediaTrackSupportedConstraintsに適合するオブジェクトが戻り値として返されます。

WebIDLでのインタフェース定義の手順で動作するため、制約は受け付けられたがサポートしていない場合エラーは発生しません。代わりに、指定された制約は解釈できなかった制約を除いて適用されるでしょう。これは混乱を招きエラーのデバッグを困難にするので、制約が暗黙的に無視されたのか制約が受け付けられたのかを知りたい場合は、getSupportedConstraints()を用いて、制約の確立を試みる前にこの情報を取得してください。

実際の制約セットはMediaTrackConstraints (en-US)ディクショナリをベースにしたオブジェクトで表現されます。

制約がどのように動作するかについての詳細を知りたい場合は、Capabilities, constraints, and settingsを読んでください。

プロパティ

オブジェクトは以下のプロパティの組み合わせであり、必ずしも全てのプロパティが含まれるわけではありません。

autoGainControl
実行環境でautoGainControl (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
width (en-US)
実行環境でwidth (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
height
実行環境でheight (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
aspectRatio
実行環境でaspectRatio (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
frameRate
実行環境でframeRate (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
facingMode
実行環境でfacingMode (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
volume
実行環境でvolume (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
sampleRate
実行環境でsampleRate (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
sampleSize
実行環境でsampleSize (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
echoCancellation
実行環境でechoCancellation (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
latency
実行環境でlatency (en-US) 制約がサポートされている場合は、Boolean型のtrueの値になります。
noiseSuppression
実行環境でnoiseSuppression (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
channelCount
実行環境でchannelCount (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
deviceId
実行環境でdeviceId (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。
groupId
実行環境でgroupId (en-US)制約がサポートされている場合は、Boolean型のtrueの値になります。

関連項目