javax.sound.sampled
클래스 AudioFileFormat

java.lang.Object 
  javax.sound.sampled.AudioFileFormat

public class AudioFileFormat
extends Object 

AudioFileFormat 클래스의 인스턴스는, 오디오 파일에 대해, 파일의 형태, 바이트수로 나타내지는 파일의 길이, 파일에 포함되는 오디오 데이터의 샘플 프레임수로 나타내지는 길이, 오디오 데이터의 형식등을 기술합니다.

AudioSystem 클래스에는, 오디오 파일 형식의 판별, 오디오 파일로부터의 오디오 입력 스트림의 취득, 및 오디오 입력 스트림로부터의 오디오 파일의 서두를 실행하는 메소드가 포함됩니다.

AudioFileFormat 객체에는, 일식의 프로퍼티을 짜넣을 수가 있습니다. 1 개의 프로퍼티은, 열쇠와 값의 페어로부터 완성됩니다. 열쇠는 String 형으로, 대응하는 프로퍼티치는 임의의 객체입니다. 프로퍼티에는, 작성자나 저작권이나 파일의 듀레이션 등, 부가적인 정보의 메타데이타를 지정합니다. 프로퍼티은 옵션 정보이므로, 파일 리더 및 파일 리더의 구현으로 프로퍼티을 제공하거나 인식하거나 하는 것은 필수가 아닙니다.

다음의 겉(표)에, 구현으로 사용되는 일반적인 프로퍼티의 예를 나타냅니다.

프로퍼티의 키	값의 형태	설명
" 「duration」"	Long	마이크로 세컨드 단위에서의 파일의 재생 듀레이션
" 「author」"	String	이 파일의 작성자의 이름
"title"	String	이 파일의 타이틀
" 「copyright」"	String	저작권 메세지
"date"	Date	녹음 또는 릴리스의 일자
" 「comment」"	String	임의의 텍스트

도입된 버젼:

1.3

관련 항목:

AudioInputStream

상자의 클래스의 개요

static class

AudioFileFormat.Type Type 클래스의 인스턴스는, 오디오 파일의 표준 타입을 나타냅니다.

생성자 의 개요

	AudioFileFormat (AudioFileFormat.Type type, AudioFormat format, int frameLength) 오디오 파일 형식 객체를 구축합니다.
	AudioFileFormat (AudioFileFormat.Type type, AudioFormat format, int frameLength, Map <String ,Object > properties) 정의된 일식의 프로퍼티을 사용해, 오디오 파일 형식 객체를 구축합니다.
protected	AudioFileFormat (AudioFileFormat.Type type, int byteLength, AudioFormat format, int frameLength) 오디오 파일 형식 객체를 구축합니다.

메소드의 개요

int	getByteLength () (오디오 데이터 뿐만이 아니라) 오디오 파일 전체의 사이즈를 바이트 단위로 가져옵니다.
AudioFormat	getFormat () 오디오 파일에 포함되는 오디오 데이터의 형식을 가져옵니다.
int	getFrameLength () 샘플 프레임수로 나타내지는, 파일에 포함되는 오디오 데이터의 길이를 가져옵니다.
Object	getProperty (String key) 키에 의해 지정된 프로퍼티치를 가져옵니다.
AudioFileFormat.Type	getType () WAVE 또는 AU 등의 오디오 파일형을 가져옵니다.
Map <String ,Object >	properties () 변경 불가능한 프로퍼티의 맵을 가져옵니다.
String	toString () 파일 형식의 캐릭터 라인 표현을 제공합니다.

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

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

생성자 의 상세

AudioFileFormat

protected AudioFileFormat(AudioFileFormat.Type  type,
                          int byteLength,
                          AudioFormat  format,
                          int frameLength)

오디오 파일 형식 객체를 구축합니다. 이 protected 생성자 은, 오디오 파일 또는 지원되고 있는 오디오 파일 형식에 관한 정보를 돌려줄 때, 파일 read 서비스를 실시하는 프로바이더에 의해 사용됩니다.

파라미터:

type - 오디오 파일의 형태

byteLength - 바이트수로 나타내지는 파일의 길이, 또는 AudioSystem.NOT_SPECIFIED

format - 파일에 포함되는 오디오 데이터의 형식

frameLength - 샘플 프레임수로 나타내지는 오디오 데이터의 길이, 또는 AudioSystem.NOT_SPECIFIED

관련 항목:

getType()

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type  type,
                       AudioFormat  format,
                       int frameLength)

오디오 파일 형식 객체를 구축합니다. 이 public 생성자 은, 요구된 오디오 파일의 프로퍼티을 기술하기 위해서 어플리케이션으로 사용할 수 있습니다.

파라미터:

type - 오디오 파일의 형태

format - 파일에 포함되는 오디오 데이터의 형식

frameLength - 샘플 프레임수로 나타내지는 오디오 데이터의 길이, 또는 AudioSystem.NOT_SPECIFIED

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type  type,
                       AudioFormat  format,
                       int frameLength,
                       Map <String ,Object > properties)

정의된 일식의 프로퍼티을 사용해, 오디오 파일 형식 객체를 구축합니다. 이 public 생성자 은, 요구된 오디오 파일의 프로퍼티을 기술하기 위해서 어플리케이션으로 사용할 수 있습니다. 프로퍼티 맵은, 변경할 수 없게 하기 위해서 카피됩니다.

파라미터:

type - 오디오 파일의 형태

format - 파일에 포함되는 오디오 데이터의 형식

frameLength - 샘플 프레임수로 나타내지는 오디오 데이터의 길이, 또는 AudioSystem.NOT_SPECIFIED

properties - 프로퍼티을 지정했다 Map<String, Object> 객체

도입된 버젼:

1.5

메소드의 상세

getType

public AudioFileFormat.Type  getType()

WAVE 또는 AU 등의 오디오 파일형을 가져옵니다.

반환값:

오디오 파일의 형태

관련 항목:

AudioFileFormat.Type.WAVE , AudioFileFormat.Type.AU , AudioFileFormat.Type.AIFF , AudioFileFormat.Type.AIFC , AudioFileFormat.Type.SND

getByteLength

public int getByteLength()

(오디오 데이터 뿐만이 아니라) 오디오 파일 전체의 사이즈를 바이트 단위로 가져옵니다.

반환값:

바이트수로 나타내지는 오디오 파일의 길이

관련 항목:

AudioSystem.NOT_SPECIFIED

getFormat

public AudioFormat  getFormat()

오디오 파일에 포함되는 오디오 데이터의 형식을 가져옵니다.

반환값:

오디오 데이터의 형식

getFrameLength

public int getFrameLength()

샘플 프레임수로 나타내지는, 파일에 포함되는 오디오 데이터의 길이를 가져옵니다.

반환값:

파일내의 오디오 데이터의 샘플 프레임수

관련 항목:

AudioSystem.NOT_SPECIFIED

properties

public Map <String ,Object > properties()

변경 불가능한 프로퍼티의 맵을 가져옵니다. 프로퍼티의 개념의 자세한 것은,클래스의 설명 을 참조해 주세요.

반환값:

모든 프로퍼티을 포함한 Map<String, Object> 객체. 프로퍼티이 1 개나 인식되지 않는 경우는, 빈 상태(empty)의 맵이 반환되는

도입된 버젼:

1.5

관련 항목:

getProperty(String)

getProperty

public Object  getProperty(String  key)

키에 의해 지정된 프로퍼티치를 가져옵니다. 프로퍼티의 개념의 자세한 것은,클래스의 설명 을 참조해 주세요.

지정한 프로퍼티이 특정의 파일 형식에서 정의되어 있지 않은 경우, 이 메소드는 null 를 돌려줍니다.

파라미터:

key - 취득하고 싶은 프로퍼티의 키

반환값:

지정된 키를 가지는 프로퍼티의 값, 또는 프로퍼티이 존재하지 않는 경우는 null

도입된 버젼:

1.5

관련 항목:

properties

toString

public String  toString()

파일 형식의 캐릭터 라인 표현을 제공합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

캐릭터 라인으로서의 파일 형식