Package org.jitsi.impl.neomedia

Class HardwareVolumeControl

java.lang.Object

org.jitsi.service.neomedia.BasicVolumeControl

org.jitsi.impl.neomedia.HardwareVolumeControl

All Implemented Interfaces:

javax.media.Control, javax.media.GainControl, VolumeControl

public class HardwareVolumeControl
extends BasicVolumeControl

Implementation of VolumeControl which uses system sound architecture (MacOsX or Windows CoreAudio) to change input/output hardware volume.

Author:

Vincent Lucas

Field Summary

Fields inherited from class org.jitsi.service.neomedia.BasicVolumeControl

MAX_VOLUME_LEVEL, MAX_VOLUME_PERCENT, MIN_VOLUME_LEVEL, MIN_VOLUME_PERCENT, volumeLevel

Fields inherited from interface org.jitsi.service.neomedia.VolumeControl

CAPTURE_VOLUME_LEVEL_PROPERTY_NAME, PLAYBACK_VOLUME_LEVEL_PROPERTY_NAME

Constructor Summary

Constructors

Constructor	Description
HardwareVolumeControl(MediaServiceImpl mediaServiceImpl, String volumeLevelConfigurationPropertyName)	Creates volume control instance and initializes initial level value if stored in the configuration service.

Method Summary

Modifier and Type	Method	Description
protected String	getCaptureDeviceUID()	Returns the selected input device UID.
protected static float	getDefaultVolumeLevel()	Returns the default volume level.
protected static float	getGainReferenceLevel()	Returns the reference volume level for computing the gain.
protected float	getInputDeviceVolume(String deviceUID)	Returns the device volume via the system API.
float	getVolume()	Current volume value.
protected int	setInputDeviceVolume(String deviceUID, float volume)	Changes the device volume via the system API.
protected void	updateHardwareVolume()	Modifies the hardware microphone sensibility (hardware amplification).

Methods inherited from class org.jitsi.service.neomedia.BasicVolumeControl

addGainChangeListener, addVolumeChangeListener, applyGain, getControlComponent, getDB, getLevel, getMaxValue, getMinValue, getMute, loadVolume, removeGainChangeListener, removeVolumeChangeListener, setDB, setLevel, setMute, setVolume

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HardwareVolumeControl

public HardwareVolumeControl(MediaServiceImpl mediaServiceImpl,
                             String volumeLevelConfigurationPropertyName)

Creates volume control instance and initializes initial level value if stored in the configuration service.

Parameters:

mediaServiceImpl - The media service implementation.

volumeLevelConfigurationPropertyName - the name of the configuration property which specifies the value of the volume level of the new instance

Method Detail

getDefaultVolumeLevel

protected static float getDefaultVolumeLevel()

Returns the default volume level.

Returns:

The default volume level.

getGainReferenceLevel

protected static float getGainReferenceLevel()

Returns the reference volume level for computing the gain.

Returns:

The reference volume level for computing the gain.

updateHardwareVolume

protected void updateHardwareVolume()

Modifies the hardware microphone sensibility (hardware amplification).

Overrides:

updateHardwareVolume in class BasicVolumeControl

getCaptureDeviceUID

protected String getCaptureDeviceUID()

Returns the selected input device UID.

Returns:

The selected input device UID. Or null if not found.

setInputDeviceVolume

protected int setInputDeviceVolume(String deviceUID,
                                   float volume)

Changes the device volume via the system API.

Parameters:

deviceUID - The device ID.

volume - The volume requested.

Returns:

0 if everything works fine.

getInputDeviceVolume

protected float getInputDeviceVolume(String deviceUID)

Returns the device volume via the system API.

Parameters:

deviceUID - The device ID.

Returns:

A scalar value between 0 and 1 if everything works fine. -1 if an error occurred.

getVolume

public float getVolume()

Current volume value.

Specified by:

getVolume in interface VolumeControl

Overrides:

getVolume in class BasicVolumeControl

Returns:

the current volume level.

See Also:

VolumeControl