LocalAudio

The LocalAudio model allows enabling and disabling the local participant's audio as well as setting and checking the capture mode and comfort noise level.

This model is supported only in SDK 3.7 and later.

Methods

getCaptureMode

getCaptureMode(): Promise<AudioCaptureModeOptions>

Returns the local participant's audio capture mode in Dolby Voice conferences.

Returns

Promise<AudioCaptureModeOptions>


setCaptureMode

setCaptureMode(options): Promise<void>

Sets the local participant's audio capture mode. The following modes are available:

  • Standard: The default mode that optimizes captured audio for speech by aggressively removing non-speech content, such as background noise. The mode is supported in SDK 3.7 and later.

  • Unprocessed: Reduces latency that comes from audio processing and prevents over-processing audio in some scenarios. The mode is supported in SDK 3.7 and later.

Note: In SDK 3.8 and prior releases, this API is supported only in Dolby Voice conferences.

Parameters

Returns

Promise<void>


getComfortNoiseLevel

getComfortNoiseLevel(): Promise<ComfortNoiseLevel>

Returns the comfort noise level setting for output devices in Dolby Voice conferences.

Returns

Promise<ComfortNoiseLevel>


setComfortNoiseLevel

setComfortNoiseLevel(noiseLevel): Promise<void>

Configures the comfort noise level for output devices in Dolby Voice conferences.

Parameters

NameTypeDescription
noiseLevelComfortNoiseLevelThe selected comfort noise level.

Returns

Promise<void>


start

start(): Promise<void>

Starts sending the local participant’s audio streams from the local client to the conference.
This method is not available for listeners in Dolby Voice conferences.

The method requires up to a few seconds to become effective.

Returns

Promise<void>


stop

stop(): Promise<void>

Stops sending local participant’s audio from the local client to the conference.
This method is not available for listeners in Dolby Voice conferences.

The method requires up to a few seconds to become effective.

Returns

Promise<void>


preview

preview(): AudioPreview

Allows the local participant to test different capture modes and voice fonts before a conference. The method sets a preview recorder that records the participant's audio and plays it back. Before playing the recorded audio, set the captureMode to a preferred setting that you wish to try. The method is supported only in SDK 3.10 and later.

Returns

AudioPreview