模块 java.desktop

包 javax.sound.sampled.spi

类 AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader extends Object 
      

提供音频文件读取服务。提供具体实现的类可以从一种或多种类型的音频文件中解析格式信息，并可以从这些类型的文件中生成音频输入流。

自从：

1.3

构造方法总结

构造方法

修饰符	构造方法	描述
protected	AudioFileReader()	子类调用的构造方法。

方法总结

修饰符和类型	方法	描述
abstract AudioFileFormat	getAudioFileFormat(File file)	获取提供的File的音频文件格式。
abstract AudioFileFormat	getAudioFileFormat(InputStream stream)	获取提供的输入流的音频文件格式。
abstract AudioFileFormat	getAudioFileFormat(URL url)	获取提供的URL的音频文件格式。
abstract AudioInputStream	getAudioInputStream(File file)	从提供的 File 获取音频输入流。
abstract AudioInputStream	getAudioInputStream(InputStream stream)	从提供的输入流中获取音频输入流。
abstract AudioInputStream	getAudioInputStream(URL url)	从提供的 URL 获取音频输入流。

在类 java.lang.Object 中声明的方法

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

构造方法详细信息

AudioFileReader

protected AudioFileReader()
            

子类调用的构造方法。

方法详情

getAudioFileFormat

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

获取提供的输入流的音频文件格式。流必须指向有效的音频文件数据。通常，音频文件读取器可能需要从流中读取一些数据才能确定是否支持它。这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，并将流的读取指针重置到其原始位置。如果输入流不支持这个，这个方法可能会失败并返回 IOException 。

参数：

stream - 应从中提取文件格式信息的输入流

返回：

描述音频文件格式的 AudioFileFormat 对象

抛出：

UnsupportedAudioFileException - 如果流没有指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 stream 是 null

参见：

• InputStream.markSupported()
• InputStream.mark(int)

getAudioFileFormat

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

获取提供的URL的音频文件格式。 URL 必须指向有效的音频文件数据。

参数：

url - 应从中提取文件格式信息的 URL

返回：

描述音频文件格式的 AudioFileFormat 对象

抛出：

UnsupportedAudioFileException - 如果 URL 未指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 url 是 null

getAudioFileFormat

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

获取提供的File的音频文件格式。 File 必须指向有效的音频文件数据。

参数：

file - 应从中提取文件格式信息的 File

返回：

描述音频文件格式的 AudioFileFormat 对象

抛出：

UnsupportedAudioFileException - 如果 File 未指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 file 是 null

getAudioInputStream

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

从提供的输入流中获取音频输入流。流必须指向有效的音频文件数据。通常，音频文件读取器可能需要从流中读取一些数据才能确定是否支持它。这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，并将流的读取指针重置到其原始位置。如果输入流不支持这个，这个方法可能会失败并返回 IOException 。

参数：

stream - 应从中构造 AudioInputStream 的输入流

返回：

基于输入流中包含的音频文件数据的 AudioInputStream 对象

抛出：

UnsupportedAudioFileException - 如果流没有指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 stream 是 null

参见：

• InputStream.markSupported()
• InputStream.mark(int)

getAudioInputStream

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

从提供的 URL 获取音频输入流。 URL 必须指向有效的音频文件数据。

参数：

url - 应为其构建 AudioInputStream 的 URL

返回：

基于 URL 指向的音频文件数据的 AudioInputStream 对象

抛出：

UnsupportedAudioFileException - 如果 URL 未指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 url 是 null

getAudioInputStream

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

从提供的 File 获取音频输入流。 File 必须指向有效的音频文件数据。

参数：

file - 应为其构建 AudioInputStream 的 File

返回：

基于 File 指向的音频文件数据的 AudioInputStream 对象

抛出：

UnsupportedAudioFileException - 如果 File 未指向系统识别的有效音频文件数据

IOException - 如果发生 I/O 异常

NullPointerException - 如果 file 是 null