javax.sound.sampled.spi
类 AudioFileReader

java.lang.Object
  javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader
extends Object

音频文件读取服务的提供程序。提供具体实现的类可以根据一种或多种类型的音频文件来分析格式信息，并且可以根据这些类型的文件生成音频输入流。

从以下版本开始：

1.3

构造方法摘要

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

public AudioFileReader()

方法详细信息

getAudioFileFormat

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

获得所提供输入流的音频文件格式。该流必须指向有效的音频文件数据。通常，音频文件 reader 可能需要在确定它们是否支持该流之前从中读取一些数据。这些解析器必须能够标记该流，读取足够量的数据来确定它们是否支持该流，如果不支持，则将该流的阅读指针重新设置到其初始位置。如果输入流不支持此操作，则此方法可能会失败，并抛出 IOException。

参数：

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

返回：

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

抛出：

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

IOException - 如果发生 I/O 异常

另请参见：

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 异常

getAudioFileFormat

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

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

参数：

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

返回：

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

抛出：

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

IOException - 如果发生 I/O 异常

getAudioInputStream

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

从所提供的输入流中获得音频输入流。该流必须指向有效的音频文件数据。通常，音频文件 reader 可能需要在确定它们是否支持该流之前从中读取一些数据。这些解析器必须能够标记该流，读取足够量的数据来确定它们是否支持该流，如果不支持，则将该流的阅读指针重新设置到其初始位置。如果输入流不支持此操作，则此方法可能会失败，并抛出 IOException。

参数：

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

返回：

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

抛出：

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

IOException - 如果发生 I/O 异常

另请参见：

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 异常

getAudioInputStream

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

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

参数：

file - 应该为其构造 AudioInputStream 的 File

返回：

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

抛出：

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

IOException - 如果发生 I/O 异常