Skip to main content
setNativeInCallAudioMode(inCallAudioMode) Sets the native in-call audio mode. Controls how the device routes audio when no external audio device (headset or Bluetooth) is connected:
  • 'video' — prefers the speakerphone (suitable for video calls viewed at a distance)
  • 'voice' — prefers the earpiece (suitable for audio-only or private calls)
If a call is already in progress and automatic device management is enabled, the new audio mode is applied immediately. Returns this for chaining.

​
Parameters

​
inCallAudioMode
'video' | 'voice'
required
The audio mode to use. 'video' routes to speakerphone; 'voice' routes to the earpiece when no headset is connected.

​
Return value

Returns this (the call object), enabling method chaining.

​
Example

// Use earpiece mode for a voice call
call.setNativeInCallAudioMode('voice');

// Switch to speakerphone mode for a video call
call.setNativeInCallAudioMode('video');

​
See also

Methods