JavaTM Platform
Standard Ed. 6

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 - 应该为其构造 AudioInputStreamFile
返回:
基于由 File 指向的音频文件数据的 AudioInputStream 对象
抛出:
UnsupportedAudioFileException - 如果 File 没有指向系统识别的有效音频文件数据
IOException - 如果发生 I/O 异常

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策