javax.sound.sampled.spi

Class AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

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

从以下版本开始：

一点三

构造方法摘要

构造方法

Constructor and Description
AudioFileWriter()

方法摘要

Modifier and Type	Method and Description
abstract AudioFileFormat.Type[]	getAudioFileTypes() 获取由该音频文件写入提供的文件写入支持的文件类型。
abstract AudioFileFormat.Type[]	getAudioFileTypes(AudioInputStream stream) 获取此音频文件写入的文件类型，可以从指定的音频输入流中写入该类型文件类型。
boolean	isFileTypeSupported(AudioFileFormat.Type fileType) 指示该音频文件写入是否为指定的文件类型提供了文件写入支持。
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) 将表示所提供的文件类型的音频文件的字节流写入到提供的输出流中。

Methods inherited from class java.lang.Object

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

Constructor Detail

AudioFileWriter

public AudioFileWriter()

方法详细信息

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

获取由该音频文件写入提供的文件写入支持的文件类型。

结果

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

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

指示该音频文件写入是否为指定的文件类型提供了文件写入支持。

参数

fileType -该文件类型的写作能力受到质疑

结果

true如果支持文件类型，否则 false

getAudioFileTypes

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

获取此音频文件写入的文件类型，可以从指定的音频输入流中写入该类型文件类型。

参数

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

将表示所提供的文件类型的音频文件的字节流写入到提供的输出流中。一些文件类型要求将长度写入文件头中，除非事先知道长度，否则无法从开始到完成写。尝试写这样的文件类型将无法与IOException如果在音频文件格式的长度是 AudioSystem.NOT_SPECIFIED。

参数

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