Disable Echo Cancellation

Disables echo cancellation on an active call.

Only do this when the input cannot produce echo in the first place — a headset, or a feed that has already been echo-cancelled upstream. On a device using open speakers, disabling this will send the remote party's own voice back to them.

Signature

disableEchoCancellation(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.disableEchoCancellation(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 echo cancellation as a call action
• Currently marked experimental
• Requires an active call — call this once media is established
• Changing one audio processing constraint preserves the other two

Related Actions

• enableEchoCancellation - Enable echo cancellation for an active call
• disableNoiseSuppression - Stop filtering background noise
• disableAutoGainControl - Stop evening out microphone input volume

Related Events

• onCallMediaError - Fired when media errors occur during a call