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가 발생 됩니다.

도입된 버전 :

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

불명한 수치를 나타내는 정수. 이 값은 보통 잘못된 값을 받지 않는 부호 첨부의 수량을 나타내는 경우에만 사용합니다. 예를 들어 파일 사이즈, 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를 내부 사용하는 고도의 메서드입니다.

시스템 프로퍼티 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를 내부 사용하는 고도의 메서드입니다.

파라미터:

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를 내부 사용하는 고도의 메서드입니다.

리턴된 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를 내부 사용하는 고도의 메서드입니다.

리턴된 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를 내부 사용하는 고도의 메서드입니다.

리턴된 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를 내부 사용하는 고도의 메서드입니다.

리턴된 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 - 변환이 지원 되지 않는 경우

관련 항목:

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

getAudioFileFormat

public static AudioFileFormat  getAudioFileFormat(InputStream  stream)
                                          throws UnsupportedAudioFileException,

                                                 IOException 

지정된 입력 스트림의 오디오 파일 형식을 취득합니다. 스트림은 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다. 이 메서드의 구현에는 스트림을 검증해 그 스트림이 지원 될지 어떨지를 판정하는 복수의 파서가 필요한 경우가 있습니다. 이러한 파서는 스트림을 마크 해, 스트림을 지원 할지 어떨지를 판정하는데 충분한 데이터를 읽어내, 지원 하지 않는 경우는 스트림의 독해 포인터를 원래의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이러한 조작을 지원 하지 않는 경우, 이 메서드는 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 

지정된 입력 스트림로부터 오디오 입력 스트림을 취득합니다. 스트림은 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다. 이 메서드의 구현에는 스트림을 검증해 그 스트림이 지원 될지 어떨지를 판정하는 복수의 파서가 필요한 경우가 있습니다. 이러한 파서는 스트림을 마크 해, 스트림을 지원 할지 어떨지를 판정하는데 충분한 데이터를 읽어내, 지원 하지 않는 경우는 스트림의 독해 포인터를 원래의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이러한 조작을 지원 하지 않는 경우, 이 메서드는 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()