FileDocCategorySizeDatePackage
VolumeControl.javaAPI DocphoneME MR2 API (J2ME)4552Wed May 02 18:00:00 BST 2007javax.microedition.media.control

VolumeControl

public interface VolumeControl implements javax.microedition.media.Control
VolumeControl is an interface for manipulating the audio volume of a Player.

Volume Settings

This interface allows the output volume to be specified using an integer value that varies between 0 and 100.

Specifying Volume in the Level Scale

The level scale specifies volume in a linear scale. It ranges from 0 to 100, where 0 represents silence and 100 represents the highest volume. The mapping for producing a linear multiplicative value is implementation dependent.

Mute

Setting mute on or off doesn't change the volume level returned by getLevel. If mute is true, no audio signal is produced by this Player; if mute is false an audio signal is produced and the volume is restored.

Volume Change Events

When the state of the VolumeControl changes, a VOLUME_CHANGED event is delivered through the PlayerListener.
see
javax.microedition.media.Control
see
javax.microedition.media.Player
see
javax.microedition.media.PlayerListener

Fields Summary
Constructors Summary
Methods Summary
public intgetLevel()
Get the current volume level set.
getLevel may return -1 if and only if the Player is in the REALIZED state (the audio device has not been initialized) and setLevel has not yet been called.

see
#setLevel
return
The current volume level or -1.

public booleanisMuted()
Get the mute state of the signal associated with this VolumeControl.

see
#setMute
return
The mute state.

public intsetLevel(int level)
Set the volume using a linear point scale with values between 0 and 100.
0 is silence; 100 is the loudest useful level that this VolumeControl supports. If the given level is less than 0 or greater than 100, the level will be set to 0 or 100 respectively.
When setLevel results in a change in the volume level, a VOLUME_CHANGED event will be delivered through the PlayerListener.

see
#getLevel
param
level The new volume specified in the level scale.
return
The level that was actually set.

public voidsetMute(boolean mute)
Mute or unmute the Player associated with this VolumeControl.
Calling setMute(true) on the Player that is already muted is ignored, as is calling setMute(false) on the Player that is not currently muted. Setting mute on or off doesn't change the volume level returned by getLevel.
When setMute results in a change in the muted state, a VOLUME_CHANGED event will be delivered through the PlayerListener.

see
#isMuted
param
mute Specify true to mute the signal, false to unmute the signal.