MediaTrackSupportedConstraints

MediaTrackSupportedConstraints 辞書はユーザーエージェントまたはブラウザーが MediaStreamTrack オブジェクトの実装で認識する制約可能なプロパティのリストを確立するものです。 MediaTrackSupportedConstraints に適合するオブジェクトは MediaDevices.getSupportedConstraints() によって返されます。

WebIDLのインターフェイス定義はこのように動作するため、制約が要求されたが対応していない場合、エラーは発生しません。代わりに、指定された制約が適用され、認識されない制約が要求から取り除かれます。これは混乱をもたらすことがあり、エラーのデバッグが困難になるので、制約を黙って無視することと制約を受け入れることの違いを知る必要がある場合は、制約を確立しようとする前に、必ず getSupportedConstraints() を使用してこの情報を取り出してください。

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

制約がどのように動作するかについての詳細を知りたい場合は、能力、制約、設定を読んでください。

プロパティ

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

autoGainControl

論理値で、値が true ならば、現在の環境で autoGainControl (en-US) 制約に対応しています。

width

論理値で、値が true ならば、現在の環境で width (en-US) 制約に対応しています。

height

論理値で、値が true ならば、現在の環境で height (en-US) 制約に対応しています。

aspectRatio

論理値で、値が true ならば、現在の環境で aspectRatio (en-US) 制約に対応しています。

frameRate

論理値で、値が true ならば、現在の環境で frameRate (en-US) 制約に対応しています。

facingMode

論理値で、値が true ならば、現在の環境で facingMode (en-US) 制約に対応しています。

resizeMode

論理値で、値が true ならば、現在の環境で resizeMode (en-US) 制約に対応しています。

volume

論理値で、値が true ならば、現在の環境で volume (en-US) 制約に対応しています。

sampleRate

論理値で、値が true ならば、現在の環境で sampleRate (en-US) 制約に対応しています。

sampleSize

論理値で、値が true ならば、現在の環境で sampleSize (en-US) 制約に対応しています。

echoCancellation

論理値で、値が true ならば、現在の環境で echoCancellation (en-US) 制約に対応しています。

latency

論理値で、値が true ならば、現在の環境で latency (en-US) 制約に対応しています。

noiseSuppression

論理値で、値が true ならば、現在の環境で noiseSuppression (en-US) 制約に対応しています。

channelCount

論理値で、値が true ならば、現在の環境で channelCount (en-US) 制約に対応しています。

deviceId

論理値で、値が true ならば、現在の環境で deviceId (en-US) 制約に対応しています。

groupId

論理値で、値が true ならば、現在の環境で groupId (en-US) 制約に対応しています。

画面共有トラックに固有のプロパティ

ユーザーの画面内コンテンツから映像ソースを含むトラックには、映像トラックで利用可能なプロパティに加え、以下のプロパティを入れることができます。

displaySurface (en-US)

論理値で、値が true ならば、現在の環境で displaySurface (en-US) 制約に対応しています。

logicalSurface (en-US)

論理値で、値が true ならば、現在の環境で logicalSurface (en-US) 制約に対応しています。

ブラウザーの互換性

BCD tables only load in the browser

関連情報