MediaTrackSupportedConstraints.autoGainControl

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

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

値

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

例

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

<div id="result"></div>

#result {
  font:
    14px "Arial",
    sans-serif;
}

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

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