javax.sound.sampled
인터페이스 Clip

모든 슈퍼 인터페이스:

DataLine , Line

public interface Clip

extends DataLine

Clip 인터페이스는 특수한 종류의 데이터 라인을 나타내, 그 오디오 데이터는 리얼타임에 스트림화하는 것이 아니라, 재생전에 로드할 수 있습니다.

데이터는 프리로드 되고 길이가 인식되고 있기 (위해)때문에, 클립을 설정하면(자) 그 오디오 데이터내의 임의의 위치로부터 재생을 개시할 수 있습니다. 또, 루프를 작성할 수도 있으므로, 클립은 재생되면(자) 반복 순환합니다. 루프는 재생하는 회수에 가세해 개시 및 종료 샘플 프레임으로 지정됩니다.

클립은 이 타입의 라인을 서포트하는 Mixer 로부터 취득할 수 있습니다. 데이터를 열면(자) 클립에 로드 됩니다.

오디오 클립의 재생은 start 및 stop 메소드를 사용해 개시 및 정지할 수 있습니다. 이러한 메소드는 미디어의 위치를 리셋트 하지 않습니다. 즉,start 메소드를 사용하면(자), 마지막에 정지한 위치로부터 재생이 시작됩니다. 클립의 오디오 데이터의 처음부터 재생을 개시하려면 , 미디어를 클립의 초에 되감는 setFramePosition(0)로 stop 를 호출합니다.

도입된 버젼:

1.3

중첩된 클래스의 개요

클래스 javax.sound.sampled. DataLine 을 상속받은 중첩된 클래스

DataLine.Info

클래스 javax.sound.sampled. Line 을 상속받은 중첩된 클래스

Line.Info

필드의 개요

static int

LOOP_CONTINUOUSLY 루프는 특정 회수 반복해 실행된 다음에 종료하는 것이 아니라 무제한하게 계속하는 것을 나타내는 값

메소드의 개요

int	getFrameLength () 미디어의 길이를 샘플 프레임수로 취득합니다.
long	getMicrosecondLength () 메디아듀레이션을 마이크로 세컨드 단위로 취득합니다.
void	loop (int count) 현재의 위치로부터 루프 재생을 개시합니다.
void	open (AudioFormat format, byte[] data, int offset, int bufferSize) 클립을 열어, 필요한 system resource를 획득해 조작 가능하게 되어 있는 것을 나타냅니다.
void	open (AudioInputStream stream) 지정된 오디오 입력 스트림내에 형식 및 오디오 데이터가 제시되고 있는 클립을 엽니다.
void	setFramePosition (int frames) 미디어의 위치를 샘플 프레임수로 설정합니다.
void	setLoopPoints (int start, int end) 루프내에서 재생되는 최초 및 마지막 샘플 프레임을 설정합니다.
void	setMicrosecondPosition (long microseconds) 미디어 위치를 마이크로 세컨드 단위로 설정합니다.

인터페이스 javax.sound.sampled. DataLine 에서 상속받은 메소드

available , drain , flush , getBufferSize , getFormat , getFramePosition , getLevel , getMicrosecondPosition , isActive , isRunning , start , stop

인터페이스 javax.sound.sampled. Line 에서 상속받은 메소드

addLineListener , close , getControl , getControls , getLineInfo , isControlSupported , isOpen , open , removeLineListener

필드의 상세

LOOP_CONTINUOUSLY

public static final int LOOP_CONTINUOUSLY

루프는 특정 회수 반복해 실행된 다음에 종료하는 것이 아니라 무제한하게 계속하는 것을 나타내는 값

관련 항목:

loop(int) , 정수 필드치

메소드의 상세

open

public void open(AudioFormat  format,
                 byte[] data,
                 int offset,
                 int bufferSize)
          throws LineUnavailableException 

클립을 열어, 필요한 system resource를 획득해 조작 가능하게 되어 있는 것을 나타냅니다. 클립은 형식과 오디오 데이터가 지정된 상태로 열립니다. 이 조작이 정상적으로 실행되면(자), 라인은 열려 있는 상태이라고 마크 되어,OPEN 이벤트는 라인의 청취자에게 디스팟치 됩니다.

벌써 열려 있는 라인으로 이 메소드를 호출하는 것은 부적절한 액션이기 (위해)때문에, IllegalStateException 가 표시되는 일이 있습니다.

라인에 따라서는 한 번 닫으면(자) 재차 열지 않는 경우가 있습니다. 이러한 라인을 재차 열려고 하면(자), 항상 이 표시됩니다.

파라미터:

format - 지정된 오디오 데이터의 형식

data - 클립에 로드하는 오디오 데이터를 포함한 바이트 배열

offset - 배열의 처음부터바이트수로 나타내지는 카피의 개시 지점

bufferSize - 배열로부터 클립에 로드하는 데이터의바이트수

예외:

LineUnavailableException - 리소스의 제약을 위해서(때문에) 라인을 열지 않는 경우

IllegalArgumentException - 버퍼 사이즈가 샘플 프레임의 적분수를 표시하지 않는 경우

IllegalStateException - 라인이 벌써 열려 있는 경우

SecurityException - 보안상의 제약을 위해서(때문에) 라인을 열지 않는 경우

관련 항목:

Line.close() , Line.isOpen() , LineListener

open

public void open(AudioInputStream  stream)
          throws LineUnavailableException ,
                 IOException 

지정된 오디오 입력 스트림내에 형식 및 오디오 데이터가 제시되고 있는 클립을 엽니다. 클립을 열면(자), 필요한 system resource를 획득해 조작 가능한 상태가 된 것을 나타냅니다. 이 조작이 입력 스트림의 경우. 조작이 정상적으로 실행되면(자), 라인은 열려 있는 상태이라고 마크 되어,OPEN 이벤트가 라인의 청취자에게 디스팟치 됩니다.

벌써 열려 있는 라인으로 이 메소드를 호출하는 것은 부적절한 액션이기 (위해)때문에, IllegalStateException 가 표시되는 일이 있습니다.

라인에 따라서는 한 번 닫으면(자) 재차 열지 않는 경우가 있습니다. 이러한 라인을 재차 열려고 하면(자), 항상 이 표시됩니다.

파라미터:

stream - 오디오 데이터가 클립에 읽히는 오디오 입력 스트림

예외:

LineUnavailableException - 리소스의 제약을 위해서(때문에) 라인을 열지 않는 경우

IOException - 스트림의 read중에 입출력 예외가 발생했을 경우

IllegalStateException - 라인이 벌써 열려 있는 경우

SecurityException - 보안상의 제약을 위해서(때문에) 라인을 열지 않는 경우

관련 항목:

Line.close() , Line.isOpen() , LineListener

getFrameLength

public int getFrameLength()

미디어의 길이를 샘플 프레임수로 취득합니다.

반환값:

샘플 프레임수로 나타내지는 미디어의 길이, 또는 라인이 열려 있지 않은 경우는 AudioSystem.NOT_SPECIFIED

관련 항목:

AudioSystem.NOT_SPECIFIED

getMicrosecondLength

public long getMicrosecondLength()

메디아듀레이션을 마이크로 세컨드 단위로 취득합니다.

반환값:

마이크로 세컨드 단위로 나타내지는 메디아듀레이션, 또는 라인이 열려 있고경우는 AudioSystem.NOT_SPECIFIED

관련 항목:

AudioSystem.NOT_SPECIFIED

setFramePosition

public void setFramePosition(int frames)

미디어의 위치를 샘플 프레임수로 설정합니다. 위치는 제로로부터 시작됩니다. 즉, 최초의 프레임은 프레임 번호 제로가 됩니다. 클립이 다음번 재생을 개시하면(자), 이 정도치의 프레임으로부터 재생이 개시됩니다.

현재의 위치를 샘플 프레임수로 취득하려면 ,DataLine 의 getFramePosition 메소드를 사용합니다.

파라미터:

frames - 샘플 프레임수로 나타내지는 필요한 신규 미디어 위치

setMicrosecondPosition

public void setMicrosecondPosition(long microseconds)

미디어 위치를 마이크로 세컨드 단위로 설정합니다. 클립이 다음번 재생을 개시하면(자), 이 정도치로부터 재생이 개시됩니다. 정밀도의 레벨은 프로텍션되지 않습니다. 예를 들어, 구현에서는 현재의 프레임 위치 및 오디오 샘플 frame rate로부터 마이크로 세컨드 위치가 계산되는 경우가 있습니다. 마이크로 세컨드 단위의 정밀도는 1 샘플 프레임 당의 마이크로 세컨드수에 제한됩니다.

현재의 위치를 마이크로 세컨드 단위로 취득하려면 ,DataLine 의 getMicrosecondPosition 메소드를 사용합니다.

파라미터:

microseconds - 마이크로 세컨드수로 나타내지는 필요한 신규 미디어 위치

setLoopPoints

public void setLoopPoints(int start,
                          int end)

루프내에서 재생되는 최초 및 마지막 샘플 프레임을 설정합니다. 최종 지점은 개시 지점보다 큰가 또는 동일하게 할 필요가 있습니다. 또, 어느 쪽의 지점도 로드 된 미디어의 사이즈내의 크기로 할 필요가 있습니다. 개시 지점을 0 의 값으로 하면(자), 로드 된 미디어의 시작을 나타냅니다. 같이 최종 지점을 -1 의 값으로 하면(자), 미디어의 최종 프레임을 나타냅니다.

파라미터:

start - 루프의 개시 위치 (샘플 프레임수, 제로로부터 시작된다)

end - 루프의 최종 위치 (샘플 프레임수, 제로로부터 시작된다), 또는 최종 프레임을 나타내는 경우는 -1

예외:

IllegalArgumentException - 요구된 루프 지점을 설정할 수 없는 경우. 통상은 개시 및 최종의 양쪽 모두 또는 어느 쪽인지가 미디어의 듀레이션외에 있기 (위해)때문에, 혹은 최종 지점이 개시 포인트의 전에 있는 것이 원인

loop

public void loop(int count)

현재의 위치로부터 루프 재생을 개시합니다. 루프의 최종 지점까지 재생되고 나서, 루프의 개시 지점에 count 회 돌아와, 마지막에 클립의 끝까지 재생합니다.

이 메소드를 호출했을 때에 현재의 위치가 루프의 최종 지점보다 커지는 경우는 루프는 실행되지 않고 클립의 끝까지 그대로 재생됩니다.

count 치를 0 으로 하면(자), 현재의 루프를 정지해 클립의 끝까지 재생을 계속하는 것을 나타냅니다. 루프의 조작중에 다른 값을 지정해 이 메소드를 호출했을 때의 동작은 정의되고 있지 않습니다.

루프중에 재생을 정지하면(자), 현재의 루프 모양태는 해제됩니다. 후속의 루프와 개시 요구의 동작은 중단된 루프 조작에 의해 영향을 받지 않습니다.

파라미터:

count - 재생이 루프의 최종 지점으로부터 루프의 개시 지점에 루프백 되는 회수, 또는 루프가 중단될 때까지 계속하는 것을 나타내는 경우는 LOOP_CONTINUOUSLY