javax.sound.sampled
인터페이스 Line

알려진 서브 인터페이스 목록 :

Clip, DataLine, Mixer, Port, SourceDataLine, TargetDataLine

public interface Line

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

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

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

객체를 등록해, 라인 상태가 변화할 때마다 통지를 받을 수가 있습니다. 객체는 단일의 메서드 update 로 구성되는 LineListener 인터페이스를 구현하고 있을 필요가 있습니다. 이 메서드는 라인의 개폐시에 호출합니다. 라인이 DataLine 인 경우는 개시 및 정지시에 호출합니다.

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

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

도입된 버전 :

1.3

관련 항목:

LineEvent

중첩(Nested) 클래스 개요

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

Line.Info  getLineInfo()

이 라인을 설명하는 Line.Info 객체를 취득합니다.

반환값:

라인의 설명

open

void open()
          throws LineUnavailableException 

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

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

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

이 메서드는 인수를 취하지 않고, 현재의 설정으로 라인을 엽니다. 이것은, SourceDataLine 객체나 TargetDataLine 객체의 경우, 라인이 디폴트 설정으로 열리는 것을의미합니다. 그러나 Clip 인 경우, 버퍼 사이즈는 데이터의 로드시로 결정됩니다. 이 메서드에서는 로드하는 데이터를 어플리케이션으로 지정할 수 없기 때문에 IllegalArgumentException가 발생 됩니다. 따라서, 이 대신에 Clip인터페이스에 갖춰지고 있는 open 메서드의 1개를 사용해, 데이터를 Clip에 로드합니다.

DataLine에 서는 라인의 취득에 사용된 DataLine.Info 객체가 1개 이상의 완전 수식 오디오 형식을 지정하는 경우, 마지막 형식이 디폴트가 됩니다.

예외:

IllegalArgumentException - 이 메서드가 Clip 인스턴스에 대해서 불려 갔을 경우

LineUnavailableException - 자원의 제약을 위해서 라인을 열지 않는 경우

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

관련 항목:

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

close

void close()

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

예외:

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

관련 항목:

open(), isOpen(), LineEvent

isOpen

boolean isOpen()

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

반환값:

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

관련 항목:

open(), close()

getControls

Control [] getControls()

이 라인에 관련된 컨트롤세트를 취득합니다. 일부의 컨트롤은 라인이 열려 있을 때 밖에 사용할 수 없습니다. 컨트롤이 없는 경우, 이 메서드는 길이 0 배열을 리턴합니다.

반환값:

컨트롤의 배열

관련 항목:

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

isControlSupported

boolean isControlSupported(Control.Type  control)

라인이 지정된 컨트롤 타입을 지원 할지 어떨지를 나타냅니다. 일부의 컨트롤은 라인이 열려 있을 때 밖에 사용할 수 없습니다.

파라미터:

control - 지원가 조회되는 컨트롤의 타입

반환값:

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

getControl

Control  getControl(Control.Type  control)

지정된 컨트롤 타입이 있는 경우, 취득합니다. 일부의 컨트롤은 라인이 열려 있을 때 밖에 사용할 수 없습니다.

파라미터:

control - 요구된 컨트롤의 타입

반환값:

지정된 타입의 컨트롤

예외:

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

관련 항목:

getControls(), isControlSupported(Control.Type control)

addLineListener

void addLineListener(LineListener  listener)

리스너에게 이 라인을 추가합니다. 라인 상태가 변화할 때마다, 리스너의 update() 메서드가 불려가 변화를 설명하는 update() 객체가 나타납니다.

파라미터:

listener - 리스너로서 이 라인에 추가하는 객체

관련 항목:

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

removeLineListener

void removeLineListener(LineListener  listener)

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

파라미터:

listener - 삭제하는 리스너

관련 항목:

addLineListener(javax.sound.sampled.LineListener)