javax.sound.sampled.spi
类 AudioFileWriter

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

public abstract class AudioFileWriter
     

      extends 
      Object
     

音频文件写入服务的提供者。提供具体实现的类可以从音频流写入一种或多种类型的音频文件。

从以下版本开始：

1.3

AudioFileWriter

public AudioFileWriter()

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

获得此音频文件 writer 为其提供文件写入支持的文件类型。

返回：

文件类型的数组。如果不支持任何文件类型，则返回一个长度为 0 的数组。

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

指示此音频文件 writer 是否提供指定文件类型的文件写入支持。

参数：

fileType - 为其查询写入功能的文件类型

返回：

如果支持该文件类型，则返回 true；否则返回 false

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)

获得此音频文件 writer 可以从指定的音频输入流写入的文件类型。

参数：

stream - 为其查询音频文件类型支持情况的音频输入流

返回：

文件类型的数组。如果不支持任何文件类型，则返回一个长度为 0 的数组。

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType,
                                   AudioInputStream stream)

指示是否可以从指示的音频输入流写入指定类型的音频文件。

参数：

fileType - 为其查询写入功能的文件类型

stream - 为其查询文件写入支持情况的流

返回：

如果支持此音频输入流的文件类型，则返回 true；否则返回 false

write

public abstract int write(AudioInputStream stream,
                          AudioFileFormat.Type fileType,
                          OutputStream out)
                   throws IOException

将表示所指示文件类型的音频文件的字节流写入所提供的输出流。一些文件类型需要将长度写入文件标题，并且不能从前往后写入，除非预先知道该长度。如果音频文件格式中的长度是 AudioSystem.NOT_SPECIFIED，则试图写入这样一个文件类型将失败，并抛出 IOException。

参数：

stream - 包含将写入输出流的音频数据的音频输入流

fileType - 将写入输出流的文件类型

out - 应该在其中写入文件数据的流

返回：

写入输出流的字节数

抛出：

IOException - 如果发生 I/O 异常

IllegalArgumentException - 如果系统不支持该文件类型

另请参见：

isFileTypeSupported(AudioFileFormat.Type, AudioInputStream), getAudioFileTypes()

write

public abstract int write(AudioInputStream stream,
                          AudioFileFormat.Type fileType,
                          File out)
                   throws IOException

将表示所指示文件格式的音频文件的字节流写入所提供的外部文件。

参数：

stream - 包含将写入文件中的音频数据的音频输入流

fileType - 将写入文件的文件类型

out - 应该将文件数据写入其中的外部文件

返回：

写入文件的字节数

抛出：

IOException - 如果发生 I/O 异常

IllegalArgumentException - 如果系统不支持该文件格式

另请参见：

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type), getAudioFileTypes()