JavaTM Platform
Standard Ed. 6

javax.sound.sampled.spi
クラス AudioFileWriter

java.lang.Object
  上位を拡張 javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

オーディオファイル書き込みサービスのプロバイダです。具象実装を提供するクラスは、オーディオストリームから 1 種類かそれ以上のオーディオファイルに書き込むことができます。

導入されたバージョン:
1.3

コンストラクタの概要
AudioFileWriter()
           
 
メソッドの概要
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)
          指定されたファイル型のオーディオファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

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
指定されたファイル型のオーディオファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。ファイルの型によっては長さをファイルヘッダーに書き込む必要があり、あらかじめ長さがわかっていないと最初から最後まで書き込むことができないものがあります。そのような型のファイルに書き込もうとしたときに、オーディオファイル形式に含まれている長さが AudioSystem.NOT_SPECIFIED であると、IOException がスローされて失敗します。

パラメータ:
stream - 出力ストリームに書き込まれるオーディオデータを含む オーディオ入力ストリーム
fileType - 出力ストリームへ書き込まれるファイル型
out - ファイルデータが書き込まれるストリーム
戻り値:
出力ストリームへ書き込まれるバイト数
例外:
IOException - 入出力例外が発生した場合
IllegalArgumentException - システムがそのファイル型をサポートしていない 場合
関連項目:
isFileTypeSupported(AudioFileFormat.Type, AudioInputStream), getAudioFileTypes()

write

public abstract int write(AudioInputStream stream,
                          AudioFileFormat.Type fileType,
                          File out)
                   throws IOException
指定されたファイル形式のオーディオファイルを表すバイトストリームを、指定された外部ファイルへ書き込みます。

パラメータ:
stream - ファイルに書き込まれるオーディオデータを含む オーディオ入力ストリーム
fileType - ファイルへ書き込まれるファイル型
out - ファイルデータが書き込まれる外部ファイル
戻り値:
ファイルへ書き込まれるバイト数
例外:
IOException - 入出力例外が発生した場合
IllegalArgumentException - システムがそのファイル形式をサポートしていない場合
関連項目:
isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type), getAudioFileTypes()

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。