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 制約に対応しています。