javax.sound.sampled
클래스 AudioSystem

java.lang.Object 
  |
  +--javax.sound.sampled.AudioSystem

public class AudioSystem

extends Object

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

도입된 버젼:

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 Line	getLine (Line.Info info) 지정된 Line.Info 오브젝트의 기술에 일치하는 라인을 취득합니다.
static Mixer	getMixer (Mixer.Info info) 요구된 오디오 mixer를 취득합니다.
static Mixer.Info []	getMixerInfo () 시스템에 현재 인스톨 되고 있는 오디오 mixer세트를 나타내는 mixer 정보 오브젝트의 배열을 취득합니다.
static Line.Info []	getSourceLineInfo (Line.Info info) 인스톨 떠날 수 있어 모든 mixer로 서포트되는 특정의 타입의 소스 라인에 관한 정보를 취득합니다.
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) 인스톨 떠날 수 있어 모든 mixer로 서포트되는 특정의 타입의 타겟 라인에 관한 정보를 취득합니다.
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 constructor 은 그러한 파라미터에 대해서 NOT_SPECIFIED 의 값을 받습니다. 문서에 나타나고 있게, 다른 메소드에서도 이 값을 받거나 돌려주거나 하는 경우가 있습니다.

관련 항목:

정수 필드치

메소드의 상세

getMixerInfo

public static Mixer.Info [] getMixerInfo()

시스템에 현재 인스톨 되고 있는 오디오 mixer세트를 나타내는 mixer 정보 오브젝트의 배열을 취득합니다.

반환값:

현재 인스톨 되고 있는 mixer의 정보 오브젝트의 배열. 시스템으로 mixer를 사용할 수 없는 경우는 길이 0 의 배열이 돌려주어지는

관련 항목:

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

getMixer

public static Mixer  getMixer(Mixer.Info  info)

요구된 오디오 mixer를 취득합니다.

파라미터:

info - 필요한 mixer를 나타내는 Mixer.Info 오브젝트, 또는 시스템의 디폴트 mixer의 경우는 null

반환값:

요구된 mixer

예외:

SecurityException - 보안상의 제약을 위해서(때문에) 요구된 mixer를 사용할 수 없는 경우

IllegalArgumentException - 정보 오브젝트가 시스템에 인스톨 된 mixer를 나타내지 않는 경우

관련 항목:

getMixerInfo()

getSourceLineInfo

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

인스톨 떠날 수 있어 모든 mixer로 서포트되는 특정의 타입의 소스 라인에 관한 정보를 취득합니다.

파라미터:

info - 정보가 요구된 라인의 종류를 지정하는 Line.Info 오브젝트

반환값:

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

관련 항목:

Mixer.getSourceLineInfo(Line.Info)

getTargetLineInfo

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

인스톨 떠날 수 있어 모든 mixer로 서포트되는 특정의 타입의 타겟 라인에 관한 정보를 취득합니다.

파라미터:

info - 정보가 요구된 라인의 종류를 지정하는 Line.Info 오브젝트

반환값:

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

관련 항목:

Mixer.getTargetLineInfo(Line.Info)

isLineSupported

public static boolean isLineSupported(Line.Info  info)

지정된 Line.Info 오브젝트에 일치하는 라인을 시스템이 서포트하고 있을지 어떨지를 나타냅니다. 라인은 인스톨 된 mixer가 서포트하는 경우는 서포트됩니다.

파라미터:

info - 서포트의 유무가 조회되는 라인을 기술하는 Line.Info 오브젝트

반환값:

일치하는 라인이 1 개 이상 서포트되는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Mixer.isLineSupported(Line.Info)

getLine

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

지정된 Line.Info 오브젝트의 기술에 일치하는 라인을 취득합니다.

파라미터:

info - 라인의 필요한 종류를 기술하는 Line.Info 오브젝트

반환값:

요구된 종류의 라인

예외:

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

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

IllegalArgumentException - 인스톨 된 mixer를 개입시켜, 지정된 Line.Info 오브젝트와 일치하는 라인을 1 행이나 시스템이 서포트하지 않는 경우

getTargetEncodings

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

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

파라미터:

sourceEncoding - 변환 서포트에 대해 조회하는 인코딩

반환값:

인코딩의 배열. 배열은 항상 현재의 인코딩 (변환 없음)을 나타내는 1 이상의 길이가 된다

getTargetEncodings

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

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

파라미터:

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

반환값:

인코딩의 배열. 배열은 항상 현재의 인코딩 (변환 없음)을 나타내는 1 이상의 길이가 된다

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 

지정된 입력 스트림의 오디오 파일 형식을 취득합니다. 스트림은 유효한 오디오 파일 데이터를 나타낼 필요가 있습니다. 이 메소드의 구현에는 스트림을 검증해 그 스트림이 서포트될지 어떨지를 판정하는 복수의 파서가 필요한 경우가 있습니다. 이러한 파서는 스트림을 마크 해, 스트림을 서포트할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 서포트하지 않는 경우는 스트림의 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()