javax.sound.sampled.spi
类 AudioFileWriter

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

public abstract class AudioFileWriter
extends Object

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

从以下版本开始：

1.3

构造方法摘要

AudioFileWriter()

方法摘要

abstract AudioFileFormat.Type[]	getAudioFileTypes() 获得此音频文件 writer 为其提供文件写入支持的文件类型。
abstract AudioFileFormat.Type[]	getAudioFileTypes(AudioInputStream stream) 获得此音频文件 writer 可以从指定的音频输入流写入的文件类型。
boolean	isFileTypeSupported(AudioFileFormat.Type fileType) 指示此音频文件 writer 是否提供指定文件类型的文件写入支持。
boolean	isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream) 指示是否可以从指示的音频输入流写入指定类型的音频文件。
abstract int	write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) 将表示所指示文件格式的音频文件的字节流写入所提供的外部文件。
abstract int	write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) 将表示所指示文件类型的音频文件的字节流写入所提供的输出流。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

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()