MediaTrackSupportedConstraints
MediaTrackSupportedConstraints
辞書はユーザーエージェントまたはブラウザーが MediaStreamTrack
オブジェクトの実装で認識する制約可能なプロパティのリストを確立するものです。 MediaTrackSupportedConstraints
に適合するオブジェクトは MediaDevices.getSupportedConstraints()
によって返されます。
WebIDLのインターフェイス定義はこのように動作するため、制約が要求されたが対応していない場合、エラーは発生しません。代わりに、指定された制約が適用され、認識されない制約が要求から取り除かれます。これは混乱をもたらすことがあり、エラーのデバッグが困難になるので、制約を黙って無視することと制約を受け入れることの違いを知る必要がある場合は、制約を確立しようとする前に、必ず getSupportedConstraints()
を使用してこの情報を取り出してください。
実際の制約セットは MediaTrackConstraints
辞書をベースにしたオブジェクトで表現されます。
制約がどのように動作するかについての詳細を知りたい場合は、能力、制約、設定を読んでください。
インスタンスプロパティ
オブジェクトは以下のプロパティの組み合わせであり、必ずしも全てのプロパティが含まれるわけではありません。
autoGainControl
-
論理値で、値が
true
ならば、現在の環境でautoGainControl
制約に対応しています。 width
-
論理値で、値が
true
ならば、現在の環境でwidth
制約に対応しています。 height
-
論理値で、値が
true
ならば、現在の環境でheight
制約に対応しています。 aspectRatio
-
論理値で、値が
true
ならば、現在の環境でaspectRatio
制約に対応しています。 frameRate
-
論理値で、値が
true
ならば、現在の環境でframeRate
制約に対応しています。 facingMode
-
論理値で、値が
true
ならば、現在の環境でfacingMode
制約に対応しています。 resizeMode
-
論理値で、値が
true
ならば、現在の環境でresizeMode
制約に対応しています。 volume
非推奨; 非標準-
論理値で、値が
true
ならば、現在の環境でvolume
制約に対応しています。 sampleRate
-
論理値で、値が
true
ならば、現在の環境でsampleRate
制約に対応しています。 sampleSize
-
論理値で、値が
true
ならば、現在の環境でsampleSize
制約に対応しています。 echoCancellation
-
論理値で、値が
true
ならば、現在の環境でechoCancellation
制約に対応しています。 latency
-
論理値で、値が
true
ならば、現在の環境でlatency
制約に対応しています。 noiseSuppression
-
論理値で、値が
true
ならば、現在の環境でnoiseSuppression
制約に対応しています。 channelCount
-
論理値で、値が
true
ならば、現在の環境でchannelCount
制約に対応しています。 deviceId
-
論理値で、値が
true
ならば、現在の環境でdeviceId
制約に対応しています。 groupId
-
論理値で、値が
true
ならば、現在の環境でgroupId
制約に対応しています。
画面共有トラックに固有のインスタンスプロパティ
ユーザーの画面内コンテンツから映像ソースを含むトラックには、映像トラックで利用可能なプロパティに加え、以下のプロパティを入れることができます。
displaySurface
-
論理値で、値が
true
ならば、現在の環境でdisplaySurface
制約に対応しています。 logicalSurface
-
論理値で、値が
true
ならば、現在の環境でlogicalSurface
制約に対応しています。