MediaTrackSettings
dictionary's
autoGainControl
property is a Boolean value whose value indicates whether or not automatic gain control (AGC) is enabled on an audio track. This lets you determine what value was selected to comply with your specified constraints for this property's value as described in the
MediaTrackConstraints.autoGainControl
property you provided when calling either
getUserMedia()
or
MediaStreamTrack.applyConstraints()
.
Automatic gain control is a feature in which a sound source automatically manages changes in the volume of its source media to maintain a steady overall volume level. This feature is typically used on microphones, although it can be provided by other input sources as well.
If needed, you can determine whether or not this constraint is supported by checking the value of
MediaTrackSupportedConstraints.autoGainControl
as returned by a call to
MediaDevices.getSupportedConstraints()
. However, typically this is unnecessary since browsers will simply ignore any constraints they're unfamiliar with.
var autoGainControl = MediaTrackSettings.autoGainControl;
A Boolean value which is
true
if the track has automatic gain control enabled or
false
if AGC is disabled.
见 Example: Constraint exerciser in Capabilities, constraints, and settings 范例。
| 规范 | 状态 | 注释 |
|---|---|---|
|
媒体捕获和流
The definition of 'autoGainControl' in that specification. |
候选推荐 | 最初的规范。 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
autoGainControl
|
Chrome Yes | Edge ≤79 |
Firefox
55
|
IE ? | Opera Yes | Safari ? | WebView Android Yes | Chrome Android Yes |
Firefox Android
55
|
Opera Android Yes | Safari iOS ? | Samsung Internet Android Yes |
完整支持
兼容性未知
要求使用供应商前缀或不同名称。
MediaTrackConstraints.autoGainControl
MediaTrackSupportedConstraints
MediaTrackSettings
AudioStreamTrack
BlobEvent
CanvasCaptureMediaStream
ConstrainBoolean
ConstrainDOMString
ConstrainDouble
ConstrainLong
DoubleRange
HTMLCanvasElement.captureStream()
LongRange
MediaDevices
MediaStream
MediaStreamTrack
MediaStreamTrackEvent
MediaTrackCapabilities
MediaTrackConstraints
MediaTrackSupportedConstraints
Navigator.mediaDevices
NavigatorUserMedia
NavigatorUserMediaError
VideoStreamTrack
navigator.mediaDevices.getUserMedia()