MediaTrackSupportedConstraints.autoGainControl

MediaTrackSupportedConstraints 辞書の autoGainControl プロパティは読み取り専用の論理値で、 MediaDevices.getSupportedConstraints() が返すオブジェクトに存在(true に設定)するならば、ユーザーエージェントautoGainControl 制約に対応しています。制約に対応していない場合、リストには含まれなくなりますので、この値が false になることはありません。

対応している制約の辞書は navigator.mediaDevices.getSupportedConstraints() を呼び出すことで取得できます。

autoGainControl 制約は、ブラウザーがメディアトラックのゲイン(音量)を自動的にコントロールする機能を提供しているかどうかを示します。これは明らかに、個々の機器が自動ゲインコントロールにも対応しているかどうかが条件となり、通常、マイクによって提供される機能です。

ユーザーエージェントが aspectRatio 制約に対応している場合、このプロパティが辞書に現れます(値は常に trueです)。このプロパティがない場合は、対応している制約の辞書から欠落しており、その値を見ようとすると undefined が返されます。

この例では、ブラウザーが autoGainControl 制約に対応しているかどうかを表示します。

js
let result = document.getElementById("result");

if (navigator.mediaDevices.getSupportedConstraints().autoGainControl) {
  result.textContent = "Supported!";
} else {
  result.textContent = "Not supported!";
}

結果

仕様書

Specification
Media Capture and Streams
# dom-mediatrackconstraintset-autogaincontrol

ブラウザーの互換性

BCD tables only load in the browser

関連情報