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