javax.microedition.media.control
Interface VolumeControl

All Superinterfaces:

Control

public interface VolumeControl

extends Control

VolumeControl은 Player의 오디오 볼륨을 조작하기 위한 인터페이스입니다.

볼륨 설정

이 인터페이스를 사용하면 0과 100 사이의 정수 값을 사용하여 출력 볼륨을 지정할 수 있습니다.

수준 스케일에서 볼륨 지정

수준 스케일은 선형 스케일로 볼륨을 지정합니다. 볼륨은 0부터 100까지이며 여기서 0은 무음을, 100은 최대 볼륨을 나타냅니다. 선형 배수를 만드는 매핑은 구현에 따라 다릅니다.

뮤트

뮤트를 설정하거나 해제하더라도 getLevel이 반환하는 볼륨 수준은 변경되지 않습니다. 뮤트가 true이면 이 Player에서 오디오 신호가 생성되지 않고 뮤트가 false이면 오디오 신호가 생성되어 볼륨이 복원됩니다.

볼륨 변경 이벤트

VolumeControl의 상태가 변경되면 VOLUME_CHANGED 이벤트가 PlayerListener를 통해 전달됩니다.

See Also:

Control, Player, PlayerListener

Method Summary

int	getLevel() 현재 볼륨 수준 설정을 가져옵니다.
boolean	isMuted() 이 VolumeControl과 연관된 신호의 뮤트 상태를 가져옵니다.
int	setLevel(int level) 값이 0부터 100 사이인 선형 스케일을 사용하여 볼륨을 설정합니다.
void	setMute(boolean mute) 이 VolumeControl에 연결된 Player의 뮤트를 설정하거나 해제합니다.

Method Detail

setMute

public void setMute(boolean mute)

이 VolumeControl에 연결된 Player의 뮤트를 설정하거나 해제합니다.

이미 뮤트된 Player에서 setMute(true)를 호출하면 무시되며 현재 뮤트되지 않은 Player에서 setMute(false)를 호출하는 것도 마찬가지입니다. 뮤트를 설정하거나 해제하더라도 getLevel이 반환하는 볼륨 수준은 변경되지 않습니다.

setMute의 결과로 뮤트 상태가 변경되면 PlayerListener를 통해 VOLUME_CHANGED 이벤트가 전달됩니다.

Parameters:

mute - 신호를 뮤트하려면 true를 지정하고 신호의 뮤트를 해제하려면 false를 지정합니다.

See Also:

isMuted()

isMuted

public boolean isMuted()

이 VolumeControl과 연관된 신호의 뮤트 상태를 가져옵니다.

Returns:

뮤트 상태

See Also:

setMute(boolean)

setLevel

public int setLevel(int level)

값이 0부터 100 사이인 선형 스케일을 사용하여 볼륨을 설정합니다.
0은 무음이고 100은 이 VolumeControl이 지원하는 가장 큰 소리입니다. 주어진 수준이 0보다 작거나 100보다 크면 수준은 각각 0이나 100으로 설정됩니다.
setLevel의 결과로 볼륨 수준이 변경되면 PlayerListener를 통해 VOLUME_CHANGED 이벤트가 전달됩니다.

Parameters:

level - 수준 스케일에 지정된 새 볼륨

Returns:

실제로 설정된 수준

See Also:

getLevel()

getLevel

public int getLevel()

현재 볼륨 수준 설정을 가져옵니다.

getLevel은 Player가 REALIZED 상태(오디오 장치가 초기화되지 않음)에 있고 setLevel이 아직 호출되지 않은 경우에만 -1을 반환할 수 있습니다.

Returns:

현재 볼륨 수준 또는 -1

See Also:

setLevel(int)