javax.sound.sampled
인터페이스 Mixer

모든 슈퍼 인터페이스:

Line

public interface Mixer

extends Line

mixer는 1 개 이상의 라인을 가지는 오디오 장치입니다. 반드시 오디오 신호를 믹싱 하도록(듯이) 설계되고 있을 필요는 없습니다. 실제로 오디오를 믹싱 하는 mixer에는 복수의 입력 (소스) 라인 및 적어도 1 개의 출력 (타겟) 라인이 있습니다. 많은 경우, 입력 라인은 SourceDataLine 을 구현하는 클래스의 인스턴스로, 출력 라인은 TargetDataLine 를 구현하는 클래스의 인스턴스입니다. Port 오브젝트도 또, 소스 라인 또는 타겟 라인의 어느 쪽인지입니다. 소스 라인의 몇개인가를 Clip 인스턴스를 구현하는 오브젝트의 인스턴스로 하는 것에 의해, mixer는 사전에 녹음된 루프 하는 사운드를 입력으로서 받아들일 수가 있습니다.

Mixer 가 확장하는 Line 인터페이스의 메소드를 통해서, mixer는 그 mixer 전체에 영향을 주는 것 같은 컨트롤세트를 갖추고 있습니다. 예를 들어, mixer는 마스터 게인 컨트롤을 가질 수가 있습니다. 이러한 글로벌인 컨트롤은 mixer의 개개의 라인에 속하는 컨트롤과는 다릅니다.

mixer 중(안)에서, 특히 내부 디지털 믹싱 기능을 가지는 것은 DataLine 인터페이스를 구현하는 것에 의해 기능을 추가할 수가 있습니다.

mixer는 라인의 동기를 서포트할 수 있습니다. 동기화 된 그룹의 1 개의 라인이 개시 또는 정지하면(자), 그룹의 다른 라인은 개시 또는 정지가 명시된 라인과 함께, 자동적으로 동시에 개시 또는 정지합니다.

도입된 버젼:

1.3

중첩된 클래스의 개요

static class

Mixer.Info Mixer.Info 클래스는 제품의 이름, 버젼, 벤더, 텍스트 설명 등, 오디오 mixer에 관한 정보를 나타냅니다.

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

Line.Info

메소드의 개요

Line	getLine (Line.Info info) 사용 가능해, 한편 지정된 Line.Info 오브젝트의 기술에 일치하는 라인을 취득합니다.
int	getMaxLines (Line.Info info) mixer로 동시에 연다, 요구된 타입의 라인의 최대수를 취득합니다.
Mixer.Info	getMixerInfo () 제품의 이름, 버젼, 벤더 등, 이 mixer에 관한 정보를 취득합니다.
Line.Info []	getSourceLineInfo () 이 mixer가 서포트하고 있는 소스 라인세트에 관한 정보를 취득합니다.
Line.Info []	getSourceLineInfo (Line.Info info) 이 mixer가 서포트하고 있는 특정의 타입의 소스 라인에 관한 정보를 취득합니다.
Line []	getSourceLines () 이 mixer에 현재 열려 있는 전소스 라인세트를 취득합니다.
Line.Info []	getTargetLineInfo () 이 mixer가 서포트하고 있는 타겟 라인세트에 관한 정보를 취득합니다.
Line.Info []	getTargetLineInfo (Line.Info info) 이 mixer가 서포트하고 있는 특정의 타입의 타겟 라인에 관한 정보를 취득합니다.
Line []	getTargetLines () 이 mixer로부터 현재 열려 있는 전타겟 라인세트를 취득합니다.
boolean	isLineSupported (Line.Info info) 지정된 Line.Info 오브젝트에 일치하는 라인을 mixer가 서포트하고 있을지 어떨지를 나타냅니다.
boolean	isSynchronizationSupported (Line [] lines, boolean maintainSync) 지정된 라인세트의 동기를 이 mixer가 서포트하고 있을지 어떨지를 보고합니다.
void	synchronize (Line [] lines, boolean maintainSync) 2 개이상의 라인을 동기화합니다.
void	unsynchronize (Line [] lines) 지정된 라인에 대해서 동기를 해제합니다.

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

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

메소드의 상세

getMixerInfo

public Mixer.Info  getMixerInfo()

제품의 이름, 버젼, 벤더 등, 이 mixer에 관한 정보를 취득합니다.

반환값:

이 mixer를 설명하는 mixer 정보 오브젝트

관련 항목:

Mixer.Info

getSourceLineInfo

public Line.Info [] getSourceLineInfo()

이 mixer가 서포트하고 있는 소스 라인세트에 관한 정보를 취득합니다.

반환값:

이 mixer의 소스 라인을 나타내는 Line.Info 오브젝트의 배열. 서포트하는 소스 라인이 없는 경우, 길이 0 의 배열이 돌려주어진다

getTargetLineInfo

public Line.Info [] getTargetLineInfo()

이 mixer가 서포트하고 있는 타겟 라인세트에 관한 정보를 취득합니다.

반환값:

이 mixer의 타겟 라인을 나타내는 Line.Info 오브젝트의 배열. 서포트하는 타겟 라인이 없는 경우, 길이 0 의 배열이 돌려주어진다

getSourceLineInfo

public Line.Info [] getSourceLineInfo(Line.Info  info)

이 mixer가 서포트하고 있는 특정의 타입의 소스 라인에 관한 정보를 취득합니다.

파라미터:

info - 정보를 조회하는 라인을 기술하는 Line.Info 오브젝트

반환값:

요구된 타입에 일치하는 소스 라인을 기술하는 Line.Info 오브젝트의 배열. 일치하는 소스 라인이 서포트되어 있지 않은 경우, 길이 0 의 배열이 돌려주어진다

getTargetLineInfo

public Line.Info [] getTargetLineInfo(Line.Info  info)

이 mixer가 서포트하고 있는 특정의 타입의 타겟 라인에 관한 정보를 취득합니다.

파라미터:

info - 정보를 조회하는 라인을 기술하는 Line.Info 오브젝트

반환값:

요구된 타입에 일치하는 타겟 라인을 기술하는 Line.Info 오브젝트의 배열. 일치하는 타겟 라인이 서포트되어 있지 않은 경우, 길이 0 의 배열이 돌려주어진다

isLineSupported

public boolean isLineSupported(Line.Info  info)

지정된 Line.Info 오브젝트에 일치하는 라인을 mixer가 서포트하고 있을지 어떨지를 나타냅니다.

파라미터:

info - 서포트의 유무에 대해 조회하는 라인의 기술

반환값:

일치하는 라인이 적어도 1 kr 서포트되는 경우는 true, 그렇지 않은 경우는 false

getLine

public Line  getLine(Line.Info  info)
             throws LineUnavailableException 

사용 가능해, 한편 지정된 Line.Info 오브젝트의 기술에 일치하는 라인을 취득합니다.

파라미터:

info - 바람직한 라인의 기술

예외:

LineUnavailableException - 리소스의 제약을 위해서(때문에), 일치하는 라인을 사용할 수 없는 경우

IllegalArgumentException - 기술에 일치하는 라인을 이 mixer가 서포트하고 있지 않는 경우

SecurityException - 보안상의 제약을 위해서(때문에), 일치하는 라인을 사용할 수 없는 경우

getMaxLines

public int getMaxLines(Line.Info  info)

mixer로 동시에 연다, 요구된 타입의 라인의 최대수를 취득합니다. 요구된 타입은 제공된 Line.Info 오브젝트의 기술에 일치하는 라인입니다. 예를 들어, 정보 오브젝트가 스피커 포토를 나타내, mixer가 정확히 1 개의 스피커 포토를 서포트하고 있는 경우, 이 메소드는 1 을 돌려줍니다. 정보 오브젝트가 소스 데이터 라인을 나타내, mixer가 32 의 소스 데이터 라인의 사용을 동시에 서포트하는 경우는 반환값은 32 입니다.

파라미터:

info - 서포트 대상의 인스턴스의 수를 조회하는 라인을 기술하는 Line.Info

반환값:

서포트 대상의 일치하는 라인의 최대수

getSourceLines

public Line [] getSourceLines()

이 mixer에 현재 열려 있는 전소스 라인세트를 취득합니다.

반환값:

이 mixer에 현재 열려 있는 소스 라인. 이 mixer에 현재 열려 있는 소스 라인이 없는 경우, 길이 0 의 배열이 돌려주어진다

예외:

SecurityException - 보안상의 제약을 위해서(때문에), 일치하는 라인을 사용할 수 없는 경우

getTargetLines

public Line [] getTargetLines()

이 mixer로부터 현재 열려 있는 전타겟 라인세트를 취득합니다.

반환값:

이 mixer로부터 현재 열려 있는 타겟 라인. 이 mixer로부터 현재 열려 있는 타겟 라인이 없는 경우, 길이 0 의 배열이 돌려주어진다

예외:

SecurityException - 보안상의 제약을 위해서(때문에), 일치하는 라인을 사용할 수 없는 경우

synchronize

public void synchronize(Line [] lines,
                        boolean maintainSync)

2 kr 이상의 라인을 동기화합니다. 이러한 라인의 1 개에 대해서 오디오의 재생 또는 취득을 개시 또는 정지시키는 후속 커멘드는 그룹의 다른 라인에도 같은 영향을 미쳐, 그러한 라인이 데이터의 재생 또는 취득을 동시에 개시 또는 정지하도록(듯이) 합니다.

파라미터:

lines - 동기화 되는 라인

maintainSync - 라인의 조작중의 전 시점에서 동기를 정확하게 유지할 필요가 있는 (즉, 동기에게 샘플 레벨의 정확함이 필요한) 경우는 true, 혹은 개시 및 정지의 조작중만 정확한 동기가 필요한 경우는 false

예외:

IllegalArgumentException - 라인을 동기화할 수 없는 경우. 이것은 라인의 타입이 다른지 이 mixer가 동기를 서포트하지 않는 다른 포맷을 라인이 가지고 있는 경우, 혹은 지정된 전라인이 이 mixer에 속하지 않은 경우에 발생한다

unsynchronize

public void unsynchronize(Line [] lines)

지정된 라인에 대해서 동기를 해제합니다. 배열은 동기가 벌써 확립되어 있는 배열과 동일하다라고 하는 것이 필요합니다. 그렇지 않은 경우는 예외가 슬로우 됩니다. 다만, 이 mixer에 속하는 현재 동기화 되고 있는 전라인이 동기가 해제되었을 경우는 null 가 지정됩니다.

파라미터:

lines - 동기를 해제하는 동기화 라인, 또는 이 mixer의 전동기화 라인의 경우는 null

예외:

IllegalArgumentException - 라인을 동기 해제할 수 없는 경우. 이것은 지정된 인수가, 동기가 벌써 확립되어 있는 라인세트에 정확하게 일치하지 않는 경우에 발생한다

isSynchronizationSupported

public boolean isSynchronizationSupported(Line [] lines,
                                          boolean maintainSync)

지정된 라인세트의 동기를 이 mixer가 서포트하고 있을지 어떨지를 보고합니다.

파라미터:

lines - 동기 서포트의 유무에 대해 조회하는 라인세트

maintainSync - 라인의 조작중의 전 시점에서 동기를 정확하게 유지할 필요가 있는 (즉, 동기에게 샘플 레벨의 정확함이 필요한) 경우는 true, 혹은 개시 및 정지의 조작중만 정확한 동기가 필요한 경우는 false

반환값:

라인을 동기화할 수 있는 경우는 true, 그렇지 않은 경우는 false