Disable Auto Gain Control
Disables auto gain control on an active call, so the microphone input level is sent unaltered.
Use this when the input is already at a known, controlled level — for example a professionally mixed feed — and the browser's automatic adjustment is working against you.
Signature
disableAutoGainControl(callId: string): Promise<void>
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
callId | string | Yes | Identifier of the active call |
Return Type
Returns a Promise that resolves once the constraint has been applied.
Usage Example
const callId = 'callId';
await client.disableAutoGainControl(callId);Errors
| Error Type | Error Code | Description |
|---|---|---|
INTERNAL_ERROR | media:error:track_not_found | No active call or no outgoing audio track found for provided callId |
UNKNOWN_ERROR | N/A | Unexpected failure |
For complete error reference and handling guidelines, see Error Reference.
Notes
- Web only. Android and iOS do not expose auto gain control
- Currently marked experimental
- Requires an active call — call this once media is established
- Changing one audio processing constraint preserves the other two
Related Actions
enableAutoGainControl- Enable auto gain control for an active calldisableNoiseSuppression- Stop filtering background noisedisableEchoCancellation- Stop cancelling speaker feedback
Related Events
onCallMediaError- Fired when media errors occur during a call