Audio Controls

Control audio during an active call session. These methods allow you to mute/unmute the local microphone and change the audio output device.

Prerequisites

An active call session
Access to the CallSession instance

Get CallSession Instance

All audio control methods are called on the CallSession singleton:

Kotlin
Java

val callSession = CallSession.getInstance()

CallSession callSession = CallSession.getInstance();

Mute Audio

Mute the local microphone. Other participants will no longer hear you.

Kotlin
Java

callSession.muteAudio()

callSession.muteAudio();

When you mute your audio, the onAudioMuted() callback is triggered on your MediaEventsListener.

Unmute Audio

Unmute the local microphone to resume transmitting audio.

Kotlin
Java

callSession.unMuteAudio()

callSession.unMuteAudio();

When you unmute your audio, the onAudioUnMuted() callback is triggered on your MediaEventsListener.

Set Audio Mode

Change the audio output device during a call. This allows users to switch between speaker, earpiece, Bluetooth, or headphones.

Kotlin
Java

// Switch to speaker
callSession.setAudioMode(AudioMode.SPEAKER)

// Switch to earpiece
callSession.setAudioMode(AudioMode.EARPIECE)

// Switch to Bluetooth
callSession.setAudioMode(AudioMode.BLUETOOTH)

// Switch to headphones
callSession.setAudioMode(AudioMode.HEADPHONES)

// Switch to speaker
callSession.setAudioMode(AudioMode.SPEAKER);

// Switch to earpiece
callSession.setAudioMode(AudioMode.EARPIECE);

// Switch to Bluetooth
callSession.setAudioMode(AudioMode.BLUETOOTH);

// Switch to headphones
callSession.setAudioMode(AudioMode.HEADPHONES);

AudioMode Enum

Value	Description
`SPEAKER`	Route audio through the device speaker
`EARPIECE`	Route audio through the phone earpiece
`BLUETOOTH`	Route audio through a connected Bluetooth device
`HEADPHONES`	Route audio through connected wired headphones

When the audio mode changes, the onAudioModeChanged(AudioMode) callback is triggered on your MediaEventsListener.

Listen for Audio Events

Kotlin
Java

callSession.addMediaEventsListener(this, object : MediaEventsListener {
    override fun onAudioMuted() {
        Log.d(TAG, "Audio muted")
        // Update UI to show muted state
    }

    override fun onAudioUnMuted() {
        Log.d(TAG, "Audio unmuted")
        // Update UI to show unmuted state
    }

    override fun onAudioModeChanged(audioMode: AudioMode) {
        Log.d(TAG, "Audio mode changed to: ${audioMode.value}")
        // Update UI to reflect new audio mode
    }

    // Other MediaEventsListener callbacks...
    override fun onRecordingStarted() {}
    override fun onRecordingStopped() {}
    override fun onScreenShareStarted() {}
    override fun onScreenShareStopped() {}
    override fun onCameraFacingChanged(cameraFacing: CameraFacing) {}
    override fun onVideoPaused() {}
    override fun onVideoResumed() {}
})

callSession.addMediaEventsListener(this, new MediaEventsListener() {
    @Override
    public void onAudioMuted() {
        Log.d(TAG, "Audio muted");
        // Update UI to show muted state
    }

    @Override
    public void onAudioUnMuted() {
        Log.d(TAG, "Audio unmuted");
        // Update UI to reflect unmuted state
    }

    @Override
    public void onAudioModeChanged(AudioMode audioMode) {
        Log.d(TAG, "Audio mode changed to: " + audioMode.getValue());
        // Update UI to reflect new audio mode
    }

    // Other MediaEventsListener callbacks...
    @Override
    public void onRecordingStarted() {}
    @Override
    public void onRecordingStopped() {}
    @Override
    public void onScreenShareStarted() {}
    @Override
    public void onScreenShareStopped() {}
    @Override
    public void onCameraFacingChanged(CameraFacing cameraFacing) {}
    @Override
    public void onVideoPaused() {}
    @Override
    public void onVideoResumed() {}
});

Initial Audio Settings

You can configure the initial audio state when joining a session using SessionSettings:

Kotlin
Java

val sessionSettings = CometChatCalls.SessionSettingsBuilder()
    .startAudioMuted(true)           // Start with microphone muted
    .setAudioMode(AudioMode.SPEAKER) // Start with speaker output
    .build()

SessionSettings sessionSettings = new CometChatCalls.SessionSettingsBuilder()
    .startAudioMuted(true)           // Start with microphone muted
    .setAudioMode(AudioMode.SPEAKER) // Start with speaker output
    .build();

Overview

Getting Started

Call Session

Features

Advanced

Migration Guide

Resources

Prerequisites

Get CallSession Instance

Mute Audio

Unmute Audio

Set Audio Mode

AudioMode Enum

Listen for Audio Events

Initial Audio Settings

Next Steps

Video Controls

Media Events Listener

​Prerequisites

​Get CallSession Instance

​Mute Audio

​Unmute Audio

​Set Audio Mode

​AudioMode Enum

​Listen for Audio Events

​Initial Audio Settings

​Next Steps

Video Controls

Media Events Listener

Prerequisites

Get CallSession Instance

Mute Audio

Unmute Audio

Set Audio Mode

AudioMode Enum

Listen for Audio Events

Initial Audio Settings

Next Steps