Muting

Overview

You can unmute both from the device and your application.

During the lifetime of a call, the user can mute or unmute their microphone many times. Depending on the design of your application, the user could mute / unmute the microphone by pressing a button on the Jabra device.

When the user does so, it is important that you also indicate to the Jabra device to do this.

Most Jabra devices can mute by interacting with the device itself (e.g., physically manipulating the boom arm).

Interacting with your application requires executing Mute or Unmute. Moreover, to keep your application's state synchronized with the device state, ensure you keep track of what the device is doing or when any changes occur.

The mute and unmute functionalities and physical interaction with the device lead to MuteState emitting the new mute state.

The following code sample shows how to subscribe to changes in the mute state, as well as how to mute and unmute:

ISingleCallControl singleCallControl; // assume `ISingleCallControl` is already instantiated

await singleCallControl.StartCall(); // Cannot mute/unmute if not in a call
singleCallControl.Mute(); // indicates that the microphone should mute
singleCallControl.Unmute(); // indicates that the microphone should not be muted anymore
singleCallControl.MuteState.Subscribe(
    (muteState) =>
    {
        // muteState = MuteState.NoOngoingCalls
        // muteState = MuteState.Unmuted (will unmute by default when starting a call)
        // muteState = MuteState.Muted
        // muteState = MuteState.Unmuted
    });

Executing Unmute while the boom arm is raised does not unmute the microphone. In practice, the mute state briefly changes to unmuted state before changing back to the mute state.

From the device

When a user mutes the device by physically interacting with the Jabra device (e.g., muting by rotating the boom arm), some Jabra devices stop transmitting audio from the microphone and send a signal to the library.

The application then listens for these signals, acknowledges that it has received the signal, and stops sending audio to other attendees in the call.

From the application

When muting through the application UI, the application must also request the device to mute through the Jabra library. Be aware that this is like a fire-and-forget API whereby the Jabra device does not respond to a mute request from the application.

Hold/Resume

The active call was either put on hold or the current active call was resumed.