javax.sound.sampled
클래스 AudioSystem

java.lang.Object 
  javax.sound.sampled.AudioSystem

public class AudioSystem
extends Object 

AudioSystem 클래스는, 샘플링 된 오디오 system resource의 엔트리 포인트로서 동작합니다. 이 클래스를 사용하면(자), 시스템에 인스톨 된 믹서에 조회 및 액세스 할 수 있습니다. AudioSystem 에는, 각종 형식간에서의 오디오 데이터의 변환이나 오디오 파일과 스트림간의 변환을 실행하기 위한 다수의 메소드가 준비되어 있습니다. 또, 믹서를 명시적으로 조작하지 않아도, 직접 AudioSystem 로부터 Line 를 취득할 수 있는 메소드도 있습니다.

프로퍼티을 사용해, 특정의 라인 타입의 디폴트 믹서를 지정할 수 있습니다. 시스템 프로퍼티, 프로퍼티 파일의 양쪽 모두 사용 가능합니다. Sun 레퍼런스 구현에서는, 프로퍼티 파일은, JRE 디렉토리내의 「lib/sound.properties」입니다. 시스템 프로퍼티이 프로퍼티 파일내에도 존재하는 경우, 시스템 프로퍼티 쪽이 우선됩니다. 프로퍼티이 전혀 지정되어 있지 않은 경우는, 사용 가능한 디바이스중에서 적절한 디폴트 프로퍼티이 선택됩니다. 프로퍼티 파일의 구문은 Properties.load 로 지정되고 있습니다. 이하의 겉(표)는, 사용 가능한 프로퍼티 키와 이것들을 인식하는 메소드의 리스트입니다.

프로퍼티 키	인터페이스	영향을 받는 메소드
javax.sound.sampled.Clip	Clip	getLine(javax.sound.sampled.Line.Info) ,getClip()
javax.sound.sampled.Port	Port	getLine(javax.sound.sampled.Line.Info)
javax.sound.sampled.SourceDataLine	SourceDataLine	getLine(javax.sound.sampled.Line.Info) ,getSourceDataLine(javax.sound.sampled.AudioFormat)
javax.sound.sampled.TargetDataLine	TargetDataLine	getLine(javax.sound.sampled.Line.Info) ,getTargetDataLine(javax.sound.sampled.AudioFormat)

프로퍼티치는, 프로바이더 클래스명과 믹서명을 해시 기호 ( 「#」)로 단락지은 형식에서 나타내집니다. 프로바이더 클래스명은, 구상믹서 프로바이더 클래스의 완전 수식명입니다. 믹서명은,Mixer.Info 의 getName 메소드로부터 반환되는 String 와 매칭 됩니다. 클래스명, 믹서명의 한편을 생략 할 수도 있습니다. 클래스명만을 지정했을 경우, 해시 기호는 생략 할 수 있습니다.

프로바이더 클래스가 지정되고 있어, 인스톨이 끝난 프로바이더로부터 정상적으로 취득할 수 있는 경우, 이 프로바이더로부터 Mixer.Info 객체의 리스트가 꺼내집니다. 그렇지 않은 경우, 또는 이러한 믹서가 이 이후 매칭을 실시하지 않는 경우,getMixerInfo() 로부터 취득한 리스트에는, 사용 가능한 모든 Mixer.Info 객체가 포함됩니다.

믹서명이 지정되면(자),Mixer.Info 객체의 결과 리스트가 검색됩니다. 일치하는 이름을 가지는 최초의 객체 (각각의 라인 인터페이스를 제공하는 Mixer 를 가진다)가 돌려주어집니다. 일치하는 Mixer.Info 객체가 발견되지 않는 경우, 또는 믹서명이 지정되어 있지 않은 경우, 결과 리스트 (각각의 라인 인터페이스를 제공)로부터 최초의 믹서가 돌려주어집니다. 예를 들어, 프로퍼티 javax.sound.sampled.Clip 의 값이 com.sun.media.sound.MixerProvider#SunClip 라고 합니다. 이 경우,getLine 호출로 Clip 인스턴스가 요구되었을 때, 인스톨이 끝난 믹서 프로바이더의 리스트내에 com.sun.media.sound.MixerProvider 클래스가 존재하고 있으면,SunClip 라는 이름의 최초의 믹서가 돌려주어집니다. 해당하는 것이 발견되지 않는 경우, 이름과는 관계없이, 지정된 프로바이더의 최초의 믹서로부터 최초의 Clip 가 돌려주어집니다. 존재하지 않는 경우는,getMixerInfo 에 의해 반환되는 모든 믹서의 리스트에 포함되는 SunClip 라는 이름의 최초의 Mixer 로부터 최초의 Clip 가 돌려주어집니다. 이것도 발견되지 않는 경우는, 모든 믹서의 리스트내의 최초의 Mixer 의 최초의 Clip 가 돌려주어집니다. 이 처리에도 실패했을 경우는,IllegalArgumentException 가 throw 됩니다.

도입된 버젼:

1.3

관련 항목:

AudioFormat , AudioInputStream , Mixer , Line , Line.Info

필드의 개요

static int

NOT_SPECIFIED 불명한 수치를 나타내는 정수.

메소드의 개요

static AudioFileFormat	getAudioFileFormat (File file) 지정된 File 의 오디오 파일 형식을 가져옵니다.
static AudioFileFormat	getAudioFileFormat (InputStream stream) 지정된 입력 스트림의 오디오 파일 형식을 가져옵니다.
static AudioFileFormat	getAudioFileFormat (URL url) 지정된 URL 의 오디오 파일 형식을 가져옵니다.
static AudioFileFormat.Type []	getAudioFileTypes () 시스템이 파일 기입 지원를 제공하는 파일형을 가져옵니다.
static AudioFileFormat.Type []	getAudioFileTypes (AudioInputStream stream) 지정된 오디오 입력 스트림로부터 시스템이 기입할 수가 있는 파일형을 가져옵니다.
static AudioInputStream	getAudioInputStream (AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream) 지정된 오디오 입력 스트림을 변환해, 나타난 인코딩의 오디오 입력 스트림을 가져옵니다.
static AudioInputStream	getAudioInputStream (AudioFormat targetFormat, AudioInputStream sourceStream) 지정된 오디오 입력 스트림을 변환해, 나타난 형식의 오디오 입력 스트림을 가져옵니다.
static AudioInputStream	getAudioInputStream (File file) 지정된 File 로부터 오디오 입력 스트림을 가져옵니다.
static AudioInputStream	getAudioInputStream (InputStream stream) 지정된 입력 스트림로부터 오디오 입력 스트림을 가져옵니다.
static AudioInputStream	getAudioInputStream (URL url) 지정된 URL 의 오디오 입력 스트림을 가져옵니다.
static Clip	getClip () 오디오 파일이나 오디오 스트림의 재생에 사용할 수 있는 클립을 가져옵니다.
static Clip	getClip (Mixer.Info mixerInfo) 오디오 파일이나 오디오 스트림의 재생에 사용되는 지정의 믹서로부터 클립을 가져옵니다.
static Line	getLine (Line.Info info) 지정된 Line.Info 객체의 기술에 일치하는 라인을 가져옵니다.
static Mixer	getMixer (Mixer.Info info) 요구된 오디오 믹서를 가져옵니다.
static Mixer.Info []	getMixerInfo () 시스템에 현재 인스톨 되고 있는 오디오 믹서세트를 나타내는 믹서 정보 객체의 배열을 가져옵니다.
static SourceDataLine	getSourceDataLine (AudioFormat format) AudioFormat 객체로 지정된 형식에서 오디오 데이터를 재생하기 위해서 사용하는 소스 데이터 라인을 가져옵니다.
static SourceDataLine	getSourceDataLine (AudioFormat format, Mixer.Info mixerinfo) AudioFormat 객체로 지정된 형식에서,Mixer.Info 객체에 의해 지정된 믹서에 의해 제공된 오디오 데이터의 재생에 사용할 수 있는 소스 데이터 라인을 가져옵니다.
static Line.Info []	getSourceLineInfo (Line.Info info) 인스톨 되고 있는 믹서로 지원되는 특정의 형태의 소스 라인에 관한 정보를 가져옵니다.
static TargetDataLine	getTargetDataLine (AudioFormat format) AudioFormat 객체로 지정된 형식에서 오디오 데이터를 녹음하기 위해서 사용하는 타겟 데이터 라인을 가져옵니다.
static TargetDataLine	getTargetDataLine (AudioFormat format, Mixer.Info mixerinfo) AudioFormat 객체로 지정된 형식에서,Mixer.Info 객체에 의해 지정된 믹서에 의해 제공된 오디오 데이터의 녹음에 사용할 수 있는 타겟 데이터 라인을 가져옵니다.
static AudioFormat.Encoding []	getTargetEncodings (AudioFormat.Encoding sourceEncoding) 인스톨 된 형식 변환세트를 사용해, 지정된 인코딩으로 오디오 입력 스트림로부터 시스템을 취득할 수 있는 인코딩을 가져옵니다.
static AudioFormat.Encoding []	getTargetEncodings (AudioFormat sourceFormat) 인스톨 된 형식 변환세트를 사용해, 지정된 형식의 오디오 입력 스트림로부터 시스템을 취득할 수 있는 인코딩을 가져옵니다.
static AudioFormat []	getTargetFormats (AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat) 특정의 인코딩을 가지는 형식, 및 인스톨 된 형식 변환세트를 사용해 지정된 형식의 스트림로부터 시스템을 취득할 수 있는 형식을 가져옵니다.
static Line.Info []	getTargetLineInfo (Line.Info info) 인스톨 되고 있는 믹서로 지원되는 특정의 형태의 타겟 라인에 관한 정보를 가져옵니다.
static boolean	isConversionSupported (AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat) 지정된 인코딩의 오디오 입력 스트림을, 지정된 형식의 오디오 입력 스트림로부터 취득할 수 있을지 어떨지를 나타냅니다.
static boolean	isConversionSupported (AudioFormat targetFormat, AudioFormat sourceFormat) 지정된 형식의 오디오 입력 스트림을, 다른 지정된 형식의 오디오 입력 스트림로부터 취득할 수 있을지 어떨지를 나타냅니다.
static boolean	isFileTypeSupported (AudioFileFormat.Type fileType) 지정된 파일형의 파일 기입 지원를 시스템이 제공하고 있을지 어떨지를 나타냅니다.
static boolean	isFileTypeSupported (AudioFileFormat.Type fileType, AudioInputStream stream) 지정된 파일형의 오디오 파일을, 나타난 오디오 입력 스트림로부터 기입할 수 있을지 어떨지를 나타냅니다.
static boolean	isLineSupported (Line.Info info) 지정된 Line.Info 객체에 일치하는 라인을 시스템이 지원하고 있을지 어떨지를 나타냅니다.
static int	write (AudioInputStream stream, AudioFileFormat.Type fileType, File out) 지정된 파일형의 오디오 파일을 나타내는 바이트의 스트림을, 지정된 외부 파일에 기입합니다.
static int	write (AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) 지정된 파일형의 오디오 파일을 나타내는 바이트의 스트림을, 지정된 출력 스트림에 기입합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

필드의 상세

NOT_SPECIFIED

public static final int NOT_SPECIFIED

불명한 수치를 나타내는 정수. 이 값은, 일반적으로0 보다 작은 값을 받지 않는 부호 첨부의 수량을 나타내는 경우에만 사용합니다. 예를 들어, 파일 사이즈, frame size, 버퍼 사이즈, 샘플 레이트가 있습니다. 몇개의 Java Sound 생성자 은, 그러한 파라미터에 대해서 NOT_SPECIFIED 의 값을 받습니다. 문서에 나타나고 있도록(듯이), 다른 메소드에서도 이 값을 받거나 돌려주거나 하는 경우가 있습니다.

관련 항목:

정수 필드치

메소드의 상세

getMixerInfo

public static Mixer.Info [] getMixerInfo()

시스템에 현재 인스톨 되고 있는 오디오 믹서세트를 나타내는 믹서 정보 객체의 배열을 가져옵니다.

반환값:

현재 인스톨 되고 있는 믹서의 정보 객체의 배열. 시스템으로 믹서를 사용할 수 없는 경우는, 길이 0 의 배열이 반환되는

관련 항목:

getMixer(javax.sound.sampled.Mixer.Info)

getMixer

public static Mixer  getMixer(Mixer.Info  info)

요구된 오디오 믹서를 가져옵니다.

파라미터:

info - 필요한 믹서를 나타내는 Mixer.Info 객체, 또는 시스템의 디폴트 믹서의 경우는 null

반환값:

요구된 믹서

예외:

SecurityException - 시큐리티상의 제약을 위해서(때문에) 요구된 믹서를 사용할 수 없는 경우

IllegalArgumentException - 정보 객체가 시스템에 인스톨 되었다 믹서를 나타내지 않는 경우

관련 항목:

getMixerInfo()

getSourceLineInfo

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

인스톨 되고 있는 믹서로 지원되는 특정의 형태의 소스 라인에 관한 정보를 가져옵니다.

파라미터:

info - 정보가 요구된 라인의 종류를 지정하는 Line.Info 객체

반환값:

요구된 형태에 일치하는 소스 라인을 기술하는 Line.Info 객체의 배열. 일치하는 소스 라인이 지원되어 있지 않은 경우, 길이 0 의 배열이 반환되는

관련 항목:

Mixer.getSourceLineInfo(Line.Info)

getTargetLineInfo

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

인스톨 되고 있는 믹서로 지원되는 특정의 형태의 타겟 라인에 관한 정보를 가져옵니다.

파라미터:

info - 정보가 요구된 라인의 종류를 지정하는 Line.Info 객체

반환값:

요구된 형태에 일치하는 타겟 라인을 기술하는 Line.Info 객체의 배열. 일치하는 타겟 라인이 지원되어 있지 않은 경우, 길이 0 의 배열이 반환되는

관련 항목:

Mixer.getTargetLineInfo(Line.Info)

isLineSupported

public static boolean isLineSupported(Line.Info  info)

지정된 Line.Info 객체에 일치하는 라인을 시스템이 지원하고 있을지 어떨지를 나타냅니다. 라인은, 인스톨 된 믹서가 지원하는 경우는 지원됩니다.

파라미터:

info - 지원의 유무가 조회되는 라인을 기술하는 Line.Info 객체

반환값:

일치하는 라인이 적어도 1 개(살) 지원되는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Mixer.isLineSupported(Line.Info)

getLine

public static Line  getLine(Line.Info  info)
                    throws LineUnavailableException 

지정된 Line.Info 객체의 기술에 일치하는 라인을 가져옵니다.

DataLine 가 요구되어 한편 info 가 DataLine.Info 의 인스턴스이며, 1 개(살) 이상의 완전 수식의 오디오 형식을 지정하는 경우, 마지막 것이 반환되는 DataLine 의 디폴트의 형식이 됩니다.

시스템 프로퍼티 javax.sound.sampled.Clip,javax.sound.sampled.Port,javax.sound.sampled.SourceDataLine, 및 javax.sound.sampled.TargetDataLine 가 정의되고 있는 경우, 또는 이것들이 sound.properties 파일내에 정의되고 있는 경우는, 이것들을 사용해 디폴트 라인을 취득할 수 있습니다. 자세한 것은,클래스의 설명 을 참조해 주세요. 각각의 프로퍼티이 설정되어 있지 않은 경우, 또는 요구된 프로퍼티이 인스톨되어 있지 않은지, 요구된 라인을 제공하지 않는 경우, 인스턴스화 된 모든 믹서로부터, 요구된 라인 타입이 조회됩니다. 요구된 라인 타입을 제공하는 최초의 믹서로부터 라인이 돌려주어집니다.

파라미터:

info - 라인의 필요한 종류를 기술하는 Line.Info 객체

반환값:

요구된 종류의 라인

예외:

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

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

IllegalArgumentException - 인스톨 된 믹서를 개입시켜, 지정된 Line.Info 객체와 일치한다 라인을 1 행이나 시스템이 지원하지 않는 경우

getClip

public static Clip  getClip()
                    throws LineUnavailableException 

오디오 파일이나 오디오 스트림의 재생에 사용할 수 있는 클립을 가져옵니다. 반환되는 클립은, 디폴트의 시스템 믹서로부터 제공됩니다. 그렇지 않은 경우는,Clip 객체를 지원하는 시스템내에 인스톨 끝난 임의의 믹서로부터 제공됩니다.

반환되는 클립은,open(AudioFormat) 또는 open(AudioInputStream) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

시스템 프로퍼티 javax.sound.sampled.Clip 가 정의되고 있는 경우, 또는 sound.properties 파일내에 정의되고 있는 경우, 이 프로퍼티은, 디폴트 클립의 취득에 사용됩니다. 자세한 것은,클래스의 설명 을 참조해 주세요.

반환값:

목적의 클립 객체

예외:

LineUnavailableException - 자원의 제약을 위해서(때문에), 클립 객체를 사용할 수 없는 경우

SecurityException - 시큐리티의 제약을 위해서(때문에), 클립 객체를 사용할 수 없는 경우

IllegalArgumentException - 시스템이 임의의 인스톨이 끝난 믹서로 1 개 이상의 클립 인스턴스를 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getClip(Mixer.Info)

getClip

public static Clip  getClip(Mixer.Info  mixerInfo)
                    throws LineUnavailableException 

오디오 파일이나 오디오 스트림의 재생에 사용되는 지정의 믹서로부터 클립을 가져옵니다.

반환되는 클립은,open(AudioFormat) 또는 open(AudioInputStream) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

파라미터:

mixerInfo - 필요한 믹서를 나타내는 Mixer.Info 객체, 또는 시스템의 디폴트 믹서의 경우는 null

반환값:

지정의 믹서로부터 취득하는 클립

예외:

LineUnavailableException - 자원의 제약을 위해서(때문에), 이 믹서로부터 클립을 사용할 수 없는 경우

SecurityException - 시큐리티의 제약을 위해서(때문에), 이 믹서로부터 클립을 사용할 수 없는 경우

IllegalArgumentException - 시스템이 지정의 믹서로 1 개 이상의 클립을 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getClip()

getSourceDataLine

public static SourceDataLine  getSourceDataLine(AudioFormat  format)
                                        throws LineUnavailableException 

AudioFormat 객체로 지정된 형식에서 오디오 데이터를 재생하기 위해서 사용하는 소스 데이터 라인을 가져옵니다. 반환되는 라인은, 디폴트의 시스템 믹서로부터 제공됩니다. 그렇지 않은 경우는, 일치하는 SourceDataLine 객체를 지원하는 임의의 인스톨이 끝난 믹서로부터 제공됩니다.

반환되는 라인은,open(AudioFormat) 또는 open(AudioFormat, int) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

반환되는 SourceDataLine 의 디폴트의 오디오 형식은,format 로 초기화됩니다.

시스템 프로퍼티 javax.sound.sampled.SourceDataLine 가 정의되고 있는 경우, 또는 sound.properties 파일내에 정의되고 있는 경우, 이 프로퍼티은, 디폴트의 소스 데이터 라인의 취득에 사용됩니다. 자세한 것은,클래스의 설명 을 참조해 주세요.

파라미터:

format - 반환되는 라인의 지원 대상 오디오 형식을 지정한다 AudioFormat 객체. 그 외의 오디오 형식의 경우는 null

반환값:

목적의 SourceDataLine 객체

예외:

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

SecurityException - 시큐리티상의 제약을 위해서(때문에), 일치하는 소스 데이터 라인을 사용할 수 없는 경우

IllegalArgumentException - 시스템이, 임의의 임의의 인스톨이 끝난 믹서에 의해 지정의 오디오 형식을 지원하는 소스 데이터 라인을 1 개 이상 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getSourceDataLine(AudioFormat, Mixer.Info)

getSourceDataLine

public static SourceDataLine  getSourceDataLine(AudioFormat  format,
                                               Mixer.Info  mixerinfo)
                                        throws LineUnavailableException 

AudioFormat 객체로 지정된 형식에서,Mixer.Info 객체에 의해 지정된 믹서에 의해 제공된 오디오 데이터의 재생에 사용할 수 있는 소스 데이터 라인을 가져옵니다.

반환되는 라인은,open(AudioFormat) 또는 open(AudioFormat, int) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

반환되는 SourceDataLine 의 디폴트의 오디오 형식은,format 로 초기화됩니다.

파라미터:

format - 반환되는 라인의 지원 대상 오디오 형식을 지정한다 AudioFormat 객체. 그 외의 오디오 형식의 경우는 null

mixerinfo - 필요한 믹서를 나타내는 Mixer.Info 객체, 또는 시스템의 디폴트 믹서의 경우는 null

반환값:

목적의 SourceDataLine 객체

예외:

LineUnavailableException - 자원의 제약을 위해서(때문에), 지정의 믹서로부터 일치하는 소스 데이터 라인을 사용할 수 없는 경우

SecurityException - 시큐리티상의 제약을 위해서(때문에), 지정의 믹서로부터 일치하는 소스 데이터 라인을 사용할 수 없는 경우

IllegalArgumentException - 지정의 믹서가, 지정의 오디오 형식을 지원하는 소스 데이터 라인을 1 개 이상 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getSourceDataLine(AudioFormat)

getTargetDataLine

public static TargetDataLine  getTargetDataLine(AudioFormat  format)
                                        throws LineUnavailableException 

AudioFormat 객체로 지정된 형식에서 오디오 데이터를 녹음하기 위해서 사용하는 타겟 데이터 라인을 가져옵니다. 반환되는 라인은, 디폴트의 시스템 믹서로부터 제공됩니다. 또는, 일치하는 TargetDataLine 객체를 지원하는 임의의 인스톨이 끝난 믹서로부터 제공됩니다.

반환되는 라인은,open(AudioFormat) 또는 open(AudioFormat, int) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

반환되는 TargetDataLine 의 디폴트의 오디오 형식은,format 로 초기화됩니다.

파라미터:

format - 반환되는 라인의 지원 대상 오디오 형식을 지정한다 AudioFormat 객체. 그 외의 오디오 형식의 경우는 null

반환값:

목적의 TargetDataLine 객체

예외:

LineUnavailableException - 자원의 제약을 위해서(때문에), 일치하는 타겟 데이터 라인을 사용할 수 없는 경우

SecurityException - 시큐리티의 제약을 위해서(때문에), 일치하는 타겟 데이터 라인을 사용할 수 없는 경우

IllegalArgumentException - 시스템이, 임의의 인스톨이 끝난 믹서에 의해 지정의 오디오 형식을 지원한다 타겟 데이터 라인을 1 개 이상 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getTargetDataLine(AudioFormat, Mixer.Info) , AudioPermission

getTargetDataLine

public static TargetDataLine  getTargetDataLine(AudioFormat  format,
                                               Mixer.Info  mixerinfo)
                                        throws LineUnavailableException 

AudioFormat 객체로 지정된 형식에서,Mixer.Info 객체에 의해 지정된 믹서에 의해 제공된 오디오 데이터의 녹음에 사용할 수 있는 타겟 데이터 라인을 가져옵니다.

반환되는 라인은,open(AudioFormat) 또는 open(AudioFormat, int) 메소드로 열리고 있을 필요가 있습니다.

이것은,getMixer 와 getLine 를 내부 사용하는 고도의 메소드입니다.

반환되는 TargetDataLine 의 디폴트의 오디오 형식은,format 로 초기화됩니다.

시스템 프로퍼티 javax.sound.sampled.TargetDataLine 가 정의되고 있는 경우, 또는 sound.properties 파일내에 정의되고 있는 경우, 이 프로퍼티은, 디폴트의 타겟 데이터 라인의 취득에 사용됩니다. 자세한 것은,클래스의 설명 을 참조해 주세요.

파라미터:

format - 반환되는 라인의 지원 대상 오디오 형식을 지정한다 AudioFormat 객체. 그 외의 오디오 형식의 경우는 null

mixerinfo - 필요한 믹서를 나타내는 Mixer.Info 객체, 또는 시스템의 디폴트 믹서의 경우는 null

반환값:

목적의 TargetDataLine 객체

예외:

LineUnavailableException - 자원의 제약을 위해서(때문에), 지정의 믹서로부터 일치하는 타겟 데이터 라인을 사용할 수 없는 경우

SecurityException - 시큐리티의 제약을 위해서(때문에), 지정의 믹서로부터 일치하는 타겟 데이터 라인을 사용할 수 없는 경우

IllegalArgumentException - 지정의 믹서가, 지정의 오디오 형식을 지원하는 타겟 데이터 라인을 1 개 이상 지원하지 않는 경우

도입된 버젼:

1.5

관련 항목:

getTargetDataLine(AudioFormat) , AudioPermission

getTargetEncodings

public static AudioFormat.Encoding [] getTargetEncodings(AudioFormat.Encoding  sourceEncoding)

인스톨 된 형식 변환세트를 사용해, 지정된 인코딩으로 오디오 입력 스트림로부터 시스템을 취득할 수 있는 인코딩을 가져옵니다.

파라미터:

sourceEncoding - 변환 지원에 대해 조회하는 인코딩

반환값:

인코딩 배열. sourceEncoding 가 지원되어 있지 않은 경우, 길이 0 의 배열이 반환된다. 그렇지 않은 경우, 배열장은 1 이상으로, sourceEncoding 를 나타낸다 (변환 없음)

getTargetEncodings

public static AudioFormat.Encoding [] getTargetEncodings(AudioFormat  sourceFormat)

인스톨 된 형식 변환세트를 사용해, 지정된 형식의 오디오 입력 스트림로부터 시스템을 취득할 수 있는 인코딩을 가져옵니다.

파라미터:

sourceFormat - 변환에 대해 조회하는 오디오 형식

반환값:

인코딩 배열. sourceFormat 가 지원되어 있지 않은 경우, 길이 0 의 배열이 반환된다. 그렇지 않은 경우, 배열장은 1 이상으로, sourceFormat 의 인코딩을 나타낸다 (변환 없음)

isConversionSupported

public static boolean isConversionSupported(AudioFormat.Encoding  targetEncoding,
                                            AudioFormat  sourceFormat)

지정된 인코딩의 오디오 입력 스트림을, 지정된 형식의 오디오 입력 스트림로부터 취득할 수 있을지 어떨지를 나타냅니다.

파라미터:

targetEncoding - 변환 후의 필요한 인코딩

sourceFormat - 변환전의 오디오 형식

반환값:

변환이 지원되고 있는 경우는 true, 그렇지 않은 경우는 false

getAudioInputStream

public static AudioInputStream  getAudioInputStream(AudioFormat.Encoding  targetEncoding,
                                                   AudioInputStream  sourceStream)

지정된 오디오 입력 스트림을 변환해, 나타난 인코딩의 오디오 입력 스트림을 가져옵니다.

파라미터:

targetEncoding - 변환 후의 필요한 인코딩

sourceStream - 변환되는 스트림

반환값:

나타난 인코딩의 오디오 입력 스트림

예외:

IllegalArgumentException - 변환이 지원되어 있지 않은 경우

관련 항목:

getTargetEncodings(AudioFormat.Encoding) , getTargetEncodings(AudioFormat) , isConversionSupported(AudioFormat.Encoding, AudioFormat) , getAudioInputStream(AudioFormat, AudioInputStream)

getTargetFormats

public static AudioFormat [] getTargetFormats(AudioFormat.Encoding  targetEncoding,
                                             AudioFormat  sourceFormat)

특정의 인코딩을 가지는 형식, 및 인스톨 된 형식 변환세트를 사용해 지정된 형식의 스트림로부터 시스템을 취득할 수 있는 형식을 가져옵니다.

파라미터:

targetEncoding - 변환 후의 필요한 인코딩

sourceFormat - 변환전의 오디오 형식

반환값:

형식의 배열. 지정된 인코딩 의 형식이 지원되지 않는 경우는, 길이 0 의 배열이 반환된다

isConversionSupported

public static boolean isConversionSupported(AudioFormat  targetFormat,
                                            AudioFormat  sourceFormat)

지정된 형식의 오디오 입력 스트림을, 다른 지정된 형식의 오디오 입력 스트림로부터 취득할 수 있을지 어떨지를 나타냅니다.

파라미터:

targetFormat - 변환 후의 필요한 오디오 형식

sourceFormat - 변환전의 오디오 형식

반환값:

변환이 지원되고 있는 경우는 true, 그렇지 않은 경우는 false

getAudioInputStream

public static AudioInputStream  getAudioInputStream(AudioFormat  targetFormat,
                                                   AudioInputStream  sourceStream)

지정된 오디오 입력 스트림을 변환해, 나타난 형식의 오디오 입력 스트림을 가져옵니다.

파라미터:

targetFormat - 변환 후의 필요한 오디오 형식

sourceStream - 변환되는 스트림

반환값:

나타난 형식의 오디오 입력 스트림

예외:

IllegalArgumentException - 변환이 지원되어 있지 않은 경우 #see #getTargetEncodings(AudioFormat)

관련 항목:

getTargetFormats(AudioFormat.Encoding, AudioFormat) , isConversionSupported(AudioFormat, AudioFormat) , getAudioInputStream(AudioFormat.Encoding, AudioInputStream)

getAudioFileFormat

public static AudioFileFormat  getAudioFileFormat(InputStream  stream)
                                          throws UnsupportedAudioFileException ,
                                                 IOException 

지정된 입력 스트림의 오디오 파일 형식을 가져옵니다. 스트림은 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다. 이 메소드의 구현에는, 스트림을 검증해 그 스트림이 지원될지 어떨지를 판정하는 복수의 퍼서가 필요한 경우가 있습니다. 이러한 퍼서는, 스트림을 마크 해, 스트림을 지원할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 지원하지 않는 경우는 스트림의 read 포인터도와의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이러한 조작을 지원하지 않는 경우, 이 메소드는 IOException 를 표시해 실패하는 일이 있습니다.

파라미터:

stream - 파일 형식 정보를 추출하는 입력 스트림

반환값:

스트림의 오디오 파일 형식을 기술하는 AudioFileFormat 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 스트림이 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getAudioFileFormat

public static AudioFileFormat  getAudioFileFormat(URL  url)
                                          throws UnsupportedAudioFileException ,
                                                 IOException 

지정된 URL 의 오디오 파일 형식을 가져옵니다. URL 는, 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

url - 파일 형식 정보를 추출하는 URL

반환값:

오디오 파일 형식을 기술하는 AudioFileFormat 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 URL 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getAudioFileFormat

public static AudioFileFormat  getAudioFileFormat(File  file)
                                          throws UnsupportedAudioFileException ,
                                                 IOException 

지정된 File 의 오디오 파일 형식을 가져옵니다. File 는 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

file - 파일 형식 정보를 추출하는 File

반환값:

오디오 파일 형식을 기술하는 AudioFileFormat 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 File 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getAudioInputStream

public static AudioInputStream  getAudioInputStream(InputStream  stream)
                                            throws UnsupportedAudioFileException ,
                                                   IOException 

지정된 입력 스트림로부터 오디오 입력 스트림을 가져옵니다. 스트림은 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다. 이 메소드의 구현에는, 스트림을 검증해 그 스트림이 지원될지 어떨지를 판정하는 복수의 퍼서가 필요한 경우가 있습니다. 이러한 퍼서는, 스트림을 마크 해, 스트림을 지원할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 지원하지 않는 경우는 스트림의 read 포인터도와의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이러한 조작을 지원하지 않는 경우, 이 메소드는 IOException 를 표시해 실패하는 일이 있습니다.

파라미터:

stream - AudioInputStream 를 구축하는 입력 스트림

반환값:

입력 스트림에 포함되는 오디오 파일 데이터에 근거하는 AudioInputStream 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 스트림이 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getAudioInputStream

public static AudioInputStream  getAudioInputStream(URL  url)
                                            throws UnsupportedAudioFileException ,
                                                   IOException 

지정된 URL 의 오디오 입력 스트림을 가져옵니다. URL 는, 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

url - AudioInputStream 를 구축하는 URL

반환값:

URL 가 가리키는 오디오 파일 데이터에 근거하는 AudioInputStream 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 URL 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getAudioInputStream

public static AudioInputStream  getAudioInputStream(File  file)
                                            throws UnsupportedAudioFileException ,
                                                   IOException 

지정된 File 로부터 오디오 입력 스트림을 가져옵니다. File 는 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

file - AudioInputStream 를 구축하는 File

반환값:

File 가 가리키는 오디오 파일 데이터에 근거하는 AudioInputStream 객체

예외:

UnsupportedAudioFileException - 시스템이 인식한 유효한 오디오 파일 데이터를 File 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getAudioFileTypes

public static AudioFileFormat.Type [] getAudioFileTypes()

시스템이 파일 기입 지원를 제공하는 파일형을 가져옵니다.

반환값:

일의의 파일형의 배열. 지원되고 있는 파일형이 없는 경우, 길이 0 의 배열이 반환된다

isFileTypeSupported

public static boolean isFileTypeSupported(AudioFileFormat.Type  fileType)

지정된 파일형의 파일 기입 지원를 시스템이 제공하고 있을지 어떨지를 나타냅니다.

파라미터:

fileType - 기입 기능이 조회되는 파일형

반환값:

파일형이 지원되고 있는 경우는 true, 그렇지 않은 경우는 false

getAudioFileTypes

public static AudioFileFormat.Type [] getAudioFileTypes(AudioInputStream  stream)

지정된 오디오 입력 스트림로부터 시스템이 기입할 수가 있는 파일형을 가져옵니다.

파라미터:

stream - 오디오 파일형의 지원가 조회되는 오디오 입력 스트림

반환값:

파일형의 배열. 지원되고 있는 파일형이 없는 경우, 길이 0 의 배열이 반환된다

isFileTypeSupported

public static boolean isFileTypeSupported(AudioFileFormat.Type  fileType,
                                          AudioInputStream  stream)

지정된 파일형의 오디오 파일을, 나타난 오디오 입력 스트림로부터 기입할 수 있을지 어떨지를 나타냅니다.

파라미터:

fileType - 기입 기능이 조회되는 파일형

stream - 파일 기입 지원가 조회되는 스트림

반환값:

파일형이 이 오디오 입력 스트림에 대해서 지원되고 있는 경우는 true, 그렇지 않은 경우는 false

write

public static int write(AudioInputStream  stream,
                        AudioFileFormat.Type  fileType,
                        OutputStream  out)
                 throws IOException 

지정된 파일형의 오디오 파일을 나타내는 바이트의 스트림을, 지정된 출력 스트림에 기입합니다. 길이를 파일 헤더에 기입할 필요가 있는 파일형도 있습니다. 미리 길이를 모르는 경우는, 그러한 형태의 파일을 최초부터 끝까지 기입할 수가 없습니다. 오디오 파일형의 길이가 AudioSystem.NOT_SPECIFIED 의 경우, 이 파일을 기입하려고 하면(자), IOException 가 표시되어 실패합니다.

파라미터:

stream - 파일에 기입해지는 오디오 데이터를 포함한 오디오 입력 스트림

fileType - 기입하는 오디오 파일의 종류

out - 파일 데이터가 기입해지는 스트림

반환값:

출력 스트림에 기입해지는 바이트수

예외:

IOException - 입출력 예외가 발생했을 경우

IllegalArgumentException - 시스템이 그 파일형을 지원하고 있지 않다 경우

관련 항목:

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type) , getAudioFileTypes()

write

public static int write(AudioInputStream  stream,
                        AudioFileFormat.Type  fileType,
                        File  out)
                 throws IOException 

지정된 파일형의 오디오 파일을 나타내는 바이트의 스트림을, 지정된 외부 파일에 기입합니다.

파라미터:

stream - 파일에 기입해지는 오디오 데이터를 포함한 오디오 입력 스트림

fileType - 기입하는 오디오 파일의 종류

out - 파일 데이터가 기입해지는 외부 파일

반환값:

파일에 기입해지는 바이트수

예외:

IOException - 입출력 예외가 발생했을 경우

IllegalArgumentException - 시스템이 그 파일형을 지원하고 있지 않다 경우

관련 항목:

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type) , getAudioFileTypes()