javax.sound.sampled
인터페이스 Line

기존의 서브 인터페이스의 일람:

Clip , DataLine , Mixer , Port , SourceDataLine , TargetDataLine

public interface Line

Line 인터페이스는 단청의 채널 또는 다중 채널의 오디오송를 나타냅니다. 라인은 mixer, 입출력 포토, mixer에의 데이터 입출력 패스등의, 디지털 오디오 「파이프라인」의 1 요소입니다.

라인은 게인, 빵, 리바브등을 컨트롤 할 수가 있습니다. 컨트롤 자체는 기저 Control 클래스를 확장하는 클래스의 인스턴스입니다. Line 인터페이스는 라인을 컨트롤하기 위한 액세스용 메소드를 2 개 제공합니다. getControls 는 세트 전체를 돌려주어,getControl 는 지정된 단일의 컨트롤을 돌려줍니다.

라인은 시간에 의해 다양한 상태로 존재합니다. 라인이 열리면(자), 라인 자체를 위해서(때문에) system resource가 확보되어 라인이 닫으면(자), 이러한 리소스는 다른 오브젝트 또는 어플리케이션을 위해서(때문에) 해방됩니다. isOpen() 메소드에 의해, 라인이 열려 있을까 닫고 있는지를 확인할 수 있습니다. 다만 라인이 열려 있어도, 데이터를 처리하고 있다고는 할 수 없습니다. 데이터 처리는 통상,SourceDataLine.write 나 TargetDataLine.read 등의 서브 인터페이스의 메소드에 의해 개시됩니다.

오브젝트를 등록해, 라인 상태가 변화할 때마다 통지를 받을 수가 있습니다. 오브젝트는 단일의 메소드 update 로 구성되는 LineListener interface 인터페이스를 구현하고 있을 필요가 있습니다. 이 메소드는 라인의 개폐시에 불려 갑니다. 라인이 DataLine 인 경우는 개시 및 정지시에 불려 갑니다.

오브젝트를 등록해 복수의 라인을 감시할 수가 있습니다. 오브젝트가 update 메소드로 수신하는 이벤트는 어느 라인이 이벤트를 작성했는지 그것은 어느 타입의 이벤트인가 (OPEN,CLOSE,START, 또는 STOP), 및 이벤트 발생시 라인이 얼마나의 샘플 프레임을 다 처리해 있는지를 지정합니다.

개폐등의 일정한 라인 조작은 라인이 공유 오디오 리소스일 때 특권을 가지지 않는 코드에 의해 불려 갔을 경우, 시큐러티 예외를 생성하는 일이 있습니다.

도입된 버젼:

1.3

관련 항목:

LineEvent

중첩된 클래스의 개요

static class

Line.Info Line.Info 오브젝트는 라인에 관한 정보를 포함하고 있습니다.

메소드의 개요

void	addLineListener (LineListener listener) 청취자에게 이 라인을 추가합니다.
void	close () 라인을 닫아 라인으로 사용하고 있던 system resource를 해방할 수 있는 것을 나타냅니다.
Control	getControl (Control.Type control) 지정된 타입의 컨트롤이 있는 경우, 그 컨트롤을 취득합니다.
Control []	getControls () 이 라인에 관련하는 컨트롤세트를 취득합니다.
Line.Info	getLineInfo () 이 라인을 설명하는 Line.Info 오브젝트를 취득합니다.
boolean	isControlSupported (Control.Type control) 지정된 타입의 컨트롤을 라인이 서포트하고 있을지 어떨지를 나타냅니다.
boolean	isOpen () 라인이 열려 있을지 어떨지 즉 현재는 사운드를 재생 또는 수집하고 있지 않아도 system resource를 확보해 조작 가능한지 어떤지를 나타냅니다.
void	open () 라인을 열어, 필요한 system resource를 획득해 조작 가능하게 되어 있는 것을 나타냅니다.
void	removeLineListener (LineListener listener) 이 라인의 청취자의 리스트로부터, 지정된 청취자를 삭제합니다.

메소드의 상세

getLineInfo

public Line.Info  getLineInfo()

이 라인을 설명하는 Line.Info 오브젝트를 취득합니다.

반환값:

라인의 설명

open

public void open()
          throws LineUnavailableException 

라인을 열어, 필요한 system resource를 획득해 조작 가능하게 되어 있는 것을 나타냅니다. 이 조작이 완료하면(자), 라인은 여는 것으로서 마크 되어OPEN 이벤트가 라인의 청취자에게 디스팟치 됩니다.

라인에 따라서는 한 번 닫으면(자) 다시 열 수 없는 점에 주의해 주세요. 이러한 라인을 재차 열려고 하면(자), 항상 LineUnavailableException 가 표시됩니다.

라인의 종류에 따라서는 리소스의 할당에 영향을 주는 설정 가능한 프로퍼티를 가지고 있는 것도 있습니다. 예를 들어,DataLine 는 특정의 포맷 및 버퍼 사이즈로 열릴 필요가 있습니다. 이러한 라인은 open 메소드, 또는 바람직한 설정을 어플리케이션으로 지정할 수 있는 메소드를 추가하는 등 해, 이러한 프로퍼티를 설정하는 기능을 제공합니다

이 메소드는 인수를 취하지 않고 현재의 설정으로 라인을 엽니다. 이것은 SourceDataLine 및 TargetDataLine 오브젝트의 경우, 라인이 디폴트 설정으로 열리는 것을 의미합니다. 그러나 Clip 의 경우, 버퍼 사이즈는 데이터를 로드할 때 결정됩니다. 이 메소드에서는 로드하는 데이터를 어플리케이션으로 지정할 수 없기 때문에, 이 메소드는 클립의 리소스에 제로 프레임의 데이터를 할당합니다. 계속되어 데이터를 그 클립에 로드하는 수단은 없습니다. 따라서, 이 대신에,Clip 인터페이스에 갖춰지고 있는 open 메소드의 1 개를 사용해, 데이터를 Clip 에 로드합니다.

예외:

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

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

관련 항목:

close() , isOpen() , LineEvent , DataLine , Clip.open(AudioFormat, byte[], int, int) , Clip.open(AudioInputStream)

close

public void close()

라인을 닫아 라인으로 사용하고 있던 system resource를 해방할 수 있는 것을 나타냅니다. 이 조작이 완료하면(자), 라인은 닫는 것으로서 마크 되어CLOSE 이벤트가 라인의 청취자에게 디스팟치 됩니다.

예외:

SecurityException - 보안상의 제약을 위해서(때문에) 라인을 닫을 수가 없는 경우

관련 항목:

open() , isOpen() , LineEvent

isOpen

public boolean isOpen()

라인이 열려 있을지 어떨지 즉 현재는 사운드를 재생 또는 수집하고 있지 않아도 system resource를 확보해 조작 가능한지 어떤지를 나타냅니다.

반환값:

라인이 열려 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

open() , close()

getControls

public Control [] getControls()

이 라인에 관련하는 컨트롤세트를 취득합니다. 컨트롤이 없는 경우는 이 메소드는 길이 0 의 배열을 돌려줍니다.

반환값:

컨트롤의 배열

관련 항목:

getControl(javax.sound.sampled.Control.Type)

isControlSupported

public boolean isControlSupported(Control.Type  control)

지정된 타입의 컨트롤을 라인이 서포트하고 있을지 어떨지를 나타냅니다.

파라미터:

control - 서포트가 조회되는 컨트롤의 타입

반환값:

지정된 타입의 컨트롤의 적어도 1 kr이 서포트되고 있는 경우는 true, 그렇지 않은 경우는 false

getControl

public Control  getControl(Control.Type  control)

지정된 타입의 컨트롤이 있는 경우, 그 컨트롤을 취득합니다.

파라미터:

control - 요구된 컨트롤의 타입

반환값:

지정된 타입의 컨트롤

예외:

IllegalArgumentException - 지정된 타입의 컨트롤이 서포트되어 있지 않은 경우

관련 항목:

getControls() , isControlSupported(Control.Type control)

addLineListener

public void addLineListener(LineListener  listener)

청취자에게 이 라인을 추가합니다. 라인 상태가 변화할 때마다, 청취자의 update() 메소드가 불려 가 변화를 설명하는 update() 오브젝트가 나타납니다.

파라미터:

listener - 청취자로서 이 라인에 추가하는 오브젝트

관련 항목:

removeLineListener(javax.sound.sampled.LineListener) , LineListener.update(javax.sound.sampled.LineEvent) , LineEvent

removeLineListener

public void removeLineListener(LineListener  listener)

이 라인의 청취자의 리스트로부터, 지정된 청취자를 삭제합니다.

파라미터:

listener - 삭제하는 청취자

관련 항목:

addLineListener(javax.sound.sampled.LineListener)