Module java.desktop
Package javax.sound.sampled.spi

Class AudioFileWriter

java.lang.Object
javax.sound.sampled.spi.AudioFileWriter
public abstract class AudioFileWriter extends Object
音频文件写入服务的提供者。提供具体实现的类可以从音频流中写入一个或多个类型的音频文件。
自版本:
1.3

  • Constructor Details

    • AudioFileWriter

      protected AudioFileWriter()
      子类调用的构造函数。

  • Method Details

    • getAudioFileTypes

      public abstract AudioFileFormat.Type[] getAudioFileTypes()
      获取此音频文件写入器提供的文件写入支持的文件类型。
      返回:
      文件类型数组。如果不支持任何文件类型，则返回长度为0的数组。

    • isFileTypeSupported

      public boolean isFileTypeSupported(AudioFileFormat.Type fileType)
      指示此音频文件写入器是否提供指定文件类型的文件写入支持。
      参数:
      fileType - 查询写入能力的文件类型
      返回:
      如果支持文件类型，则返回true，否则返回false
      抛出:
      NullPointerException - 如果fileType为null

    • getAudioFileTypes

      public abstract AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)
      获取此音频文件写入器可以从指定的音频输入流中写入的文件类型。
      参数:
      stream - 查询音频文件类型支持的音频输入流
      返回:
      文件类型数组。如果不支持任何文件类型，则返回长度为0的数组。
      抛出:
      NullPointerException - 如果stream为null

    • isFileTypeSupported

      public boolean isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)
      指示是否可以从指定的音频输入流中写入指定类型的音频文件。
      参数:
      fileType - 查询写入能力的文件类型
      stream - 查询文件写入支持的流
      返回:
      如果此音频输入流支持文件类型，则返回true，否则返回false
      抛出:
      NullPointerException - 如果fileType或stream为null

    • 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 - 如果系统不支持文件类型
      NullPointerException - 如果stream或fileType或out为null
      参见:

    • write

      public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) throws IOException
      将表示指定文件格式的音频文件的字节流写入提供的外部文件。
      参数:
      stream - 包含要写入文件的音频数据的音频输入流
      fileType - 要写入文件的文件类型
      out - 应写入文件数据的外部文件
      返回:
      写入文件的字节数
      抛出:
      IOException - 如果发生I/O异常
      IllegalArgumentException - 如果系统不支持文件格式
      NullPointerException - 如果stream或fileType或out为null
      参见: