Skip to content

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 ​

ParameterTypeRequiredDescription
callIdstringYesIdentifier 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 TypeError CodeDescription
INTERNAL_ERRORmedia:error:track_not_foundNo active call or no outgoing audio track found for provided callId
UNKNOWN_ERRORN/AUnexpected 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

Built with VitePress.