Audio Controls

CometChat Calls SDK v5 — Audio Controls

Overview

Programmatically control the local microphone (mute/unmute) and audio output device (speaker, earpiece, Bluetooth, headphones) during an active call.

Key Imports

import com.cometchat.calls.core.CallSession
import com.cometchat.calls.model.AudioMode
import com.cometchat.calls.listeners.MediaEventsListener

Implementation

Mute / Unmute

val callSession = CallSession.getInstance()

callSession.muteAudio()    // mute microphone
callSession.unmuteAudio()  // unmute microphone

Switch Audio Output

callSession.setAudioMode(AudioMode.SPEAKER)     // loudspeaker
callSession.setAudioMode(AudioMode.EARPIECE)     // phone earpiece
callSession.setAudioMode(AudioMode.BLUETOOTH)    // connected Bluetooth device
callSession.setAudioMode(AudioMode.HEADPHONES)   // wired headphones

Listen for Audio Events

callSession.addMediaEventsListener(this, object : MediaEventsListener() {
    override fun onAudioMuted() {
        // Update mute button to "muted" state
    }
    override fun onAudioUnMuted() {
        // Update mute button to "unmuted" state
    }
    override fun onAudioModeChanged(audioMode: AudioMode) {
        when (audioMode) {
            AudioMode.SPEAKER -> { /* update icon */ }
            AudioMode.EARPIECE -> { /* update icon */ }
            AudioMode.BLUETOOTH -> { /* update icon */ }
            AudioMode.HEADPHONES -> { /* update icon */ }
        }
    }
    // ... other required overrides
    override fun onVideoPaused() {}
    override fun onVideoResumed() {}
    override fun onRecordingStarted() {}
    override fun onRecordingStopped() {}
    override fun onCameraFacingChanged(facing: CameraFacing) {}
})

Initial Audio Settings (Pre-Session)

val sessionSettings = CometChatCalls.SessionSettingsBuilder()
    .startAudioMuted(true)              // join muted
    .setAudioMode(AudioMode.SPEAKER)    // initial output device
    .hideToggleAudioButton(false)       // show mute button
    .hideAudioModeButton(false)         // show audio mode button
    .build()

Gotchas

• muteAudio() / unmuteAudio() only work during an active session
• Audio mode changes trigger onAudioModeChanged() on MediaEventsListener
• AudioMode enum: SPEAKER, EARPIECE, BLUETOOTH, HEADPHONES
• For voice calls, default to AudioMode.EARPIECE; for video calls, default to AudioMode.SPEAKER
• Bluetooth audio mode only works when a Bluetooth device is connected

Sample App Reference

• CallActivity.kt — Sets AudioMode.EARPIECE for voice calls, AudioMode.SPEAKER for video calls