com.zoiper.zdk.EventHandlers

Interface AudioEventsHandler

public interface AudioEventsHandler

Method Summary

Modifier and Type	Method and Description
default void	onDeviceError(AudioDevice audioDevice, AudioDeviceState deviceState) An error occurred with an audio device An error occurred, usually when attempting to open a device.
default void	onDeviceOpenError(java.util.List<AudioDevice> deviceList) An error occurred when trying to open an audio device An error occurred when attempting to open an audio device or an internal processing stream.
default void	onDeviceStateChange(AudioDevice audioDevice, AudioDeviceState deviceState) Notify upon audio device changed its state
default void	onEnergyLevelChange(double inLevel, double outLevel) Notify upon input/output sound energy level changed This callback is fired when the audio subsystem detects a change in the sound energy levels for the input (microphone) and/or output (speaker) measured in dBm0.
default void	onInputLevelChange(AudioDevice audioDevice, double level) Notify upon input volume level changed This callback is fired when the audio subsystem detects a change in the input volume settings caused by external factors (for example the user changing the input device volume from the system mixer).
default void	onOutputLevelChange(AudioDevice audioDevice, double level) Notify upon output volume level changed This callback is fired when the audio subsystem detects a change in the output volume settings caused by external factors (for example the user changing the output device volume from the system mixer).
default void	onRingLevelChange(AudioDevice audioDevice, double level) Notify upon Ringing volume level changed This callback is fired when the audio subsystem detects a change in the Ringing volume settings caused by external factors (for example the user changing the ring device volume from the system mixer).

Method Detail

onInputLevelChange

default void onInputLevelChange(AudioDevice audioDevice,
                                double level)

Notify upon input volume level changed This callback is fired when the audio subsystem detects a change in the input volume settings caused by external factors (for example the user changing the input device volume from the system mixer). The rate of this callback is controlled by the delta setting configured by audioEndpointControl::AudioDeltaLevel.

Parameters:

audioDevice - The audio device

level - Input level from 0.0 (silent) to 1.0 (full volume)

See Also:

AudioDevice

onOutputLevelChange

default void onOutputLevelChange(AudioDevice audioDevice,
                                 double level)

Notify upon output volume level changed This callback is fired when the audio subsystem detects a change in the output volume settings caused by external factors (for example the user changing the output device volume from the system mixer). The rate of this callback is controlled by the delta setting configured by audioEndpointControl::AudioDeltaLevel.

Parameters:

audioDevice - The audio device

level - Output level from 0.0 (silent) to 1.0 (full volume)

See Also:

AudioDevice

onRingLevelChange

default void onRingLevelChange(AudioDevice audioDevice,
                               double level)

Notify upon Ringing volume level changed This callback is fired when the audio subsystem detects a change in the Ringing volume settings caused by external factors (for example the user changing the ring device volume from the system mixer). The rate of this callback is controlled by the delta setting configured by audioEndpointControl::AudioDeltaLevel.

Parameters:

audioDevice - The audio device

level - Ringing level from 0.0 (silent) to 1.0 (full volume)

See Also:

AudioDevice

onEnergyLevelChange

default void onEnergyLevelChange(double inLevel,
                                 double outLevel)

Notify upon input/output sound energy level changed This callback is fired when the audio subsystem detects a change in the sound energy levels for the input (microphone) and/or output (speaker) measured in dBm0. The sound energy density is measured one and only when there is opened audio device - e.g. during a call or while playing a sound!

Parameters:

inLevel - Input/microphone energy level in dBm0

outLevel - Output/speaker energy level in dBm0

onDeviceStateChange

default void onDeviceStateChange(AudioDevice audioDevice,
                                 AudioDeviceState deviceState)

Notify upon audio device changed its state

Parameters:

audioDevice - The audio device

deviceState - Audio device state

See Also:

AudioDeviceState

onDeviceError

default void onDeviceError(AudioDevice audioDevice,
                           AudioDeviceState deviceState)

An error occurred with an audio device An error occurred, usually when attempting to open a device. This is an error coming from the OS API. Audio configuration diagnostic or actual user action is recommended.

Parameters:

audioDevice - The audio device

deviceState - Audio device state

See Also:

AudioDeviceState

onDeviceOpenError

default void onDeviceOpenError(java.util.List<AudioDevice> deviceList)

An error occurred when trying to open an audio device An error occurred when attempting to open an audio device or an internal processing stream. Audio configuration diagnostic or actual user action is recommended.

Parameters:

deviceList - A list of the devices which failed to open

See Also:

AudioDevice