モジュール java.desktop
パッケージ javax.sound.sampled.spi

クラスAudioFileWriter


  • public abstract class AudioFileWriter
extends Object
    オーディオ・ファイル書込みサービスのプロバイダです。 具象実装を提供するクラスは、オーディオ・ストリームから1種類かそれ以上のオーディオ・ファイルに書き込むことができます。
    導入されたバージョン:
    1.3

    • コンストラクタの詳細

      • AudioFileWriter

        public AudioFileWriter​()

    • メソッドの詳細

      • 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 - 入出力例外が発生した場合
        IllegalArgumentException - システムがそのファイル・タイプをサポートしていない場合
        NullPointerException - streamまたはfileTypeまたはoutがnull
        関連項目:
        isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()

      • write

        public abstract int write​(AudioInputStream stream,
                          AudioFileFormat.Type fileType,
                          File out)
                   throws IOException
        指定されたファイル形式のオーディオ・ファイルを表すバイト・ストリームを、指定された外部ファイルへ書き込みます。
        パラメータ:
        stream - ファイルに書き込まれるオーディオ・データを含むオーディオ入力ストリーム
        fileType - ファイルへ書き込まれるファイル・タイプ
        out - ファイル・データが書き込まれる外部ファイル
        戻り値:
        ファイルへ書き込まれるバイト数
        例外:
        IOException - 入出力例外が発生した場合
        IllegalArgumentException - システムがそのファイル形式をサポートしていない場合
        NullPointerException - streamまたはfileTypeまたはoutがnull
        関連項目:
        isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()