javax.sound.sampled.spi

クラスAudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader
extends Object

オーディオ・ファイル読込みサービスのプロバイダです。具象実装を備えているクラスは、1種類以上のオーディオ・ファイルから形式情報を構文解析することができます。また、これらのタイプのファイルからオーディオ入力ストリームを生成することもできます。

導入されたバージョン:

1.3

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
AudioFileReader()

メソッドのサマリー

修飾子と型	メソッドと説明
abstract AudioFileFormat	getAudioFileFormat(File file) 指定されたFileのオーディオ・ファイル形式を取得します。
abstract AudioFileFormat	getAudioFileFormat(InputStream stream) 指定された入力ストリームのオーディオ・ファイル形式を取得します。
abstract AudioFileFormat	getAudioFileFormat(URL url) 指定されたURLのオーディオ・ファイル形式を取得します。
abstract AudioInputStream	getAudioInputStream(File file) 指定されたFileからオーディオ入力ストリームを取得します。
abstract AudioInputStream	getAudioInputStream(InputStream stream) 指定された入力ストリームからオーディオ入力ストリームを取得します。
abstract AudioInputStream	getAudioInputStream(URL url) 指定されたURLのオーディオ入力ストリームを取得します。

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

AudioFileReader

public AudioFileReader()

メソッドの詳細

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(InputStream stream)
                                            throws UnsupportedAudioFileException,
                                                   IOException

指定された入力ストリームのオーディオ・ファイル形式を取得します。ストリームは有効なオーディオ・ファイル・データを示す必要があります。一般的に、オーディオ・ファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - ファイル形式情報を抽出する入力ストリーム

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

関連項目:

InputStream.markSupported(), InputStream.mark(int)

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(URL url)
                                            throws UnsupportedAudioFileException,
                                                   IOException

指定されたURLのオーディオ・ファイル形式を取得します。URLは、有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

url - ファイル形式情報を抽出するURL

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをURLが示さない場合

IOException - 入出力例外が発生した場合

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(File file)
                                            throws UnsupportedAudioFileException,
                                                   IOException

指定されたFileのオーディオ・ファイル形式を取得します。Fileは有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

file - ファイル形式情報を抽出するFile

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(InputStream stream)
                                              throws UnsupportedAudioFileException,
                                                     IOException

指定された入力ストリームからオーディオ入力ストリームを取得します。ストリームは有効なオーディオ・ファイル・データを示す必要があります。一般的に、オーディオ・ファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - AudioInputStreamを構築する入力ストリーム

戻り値:

入力ストリームに含まれるオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト。

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

関連項目:

InputStream.markSupported(), InputStream.mark(int)

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(URL url)
                                              throws UnsupportedAudioFileException,
                                                     IOException

指定されたURLのオーディオ入力ストリームを取得します。URLは、有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

url - AudioInputStreamを構築するURL

戻り値:

URLが示すオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをURLが示さない場合

IOException - 入出力例外が発生した場合

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(File file)
                                              throws UnsupportedAudioFileException,
                                                     IOException

指定されたFileからオーディオ入力ストリームを取得します。Fileは有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

file - AudioInputStreamを構築するFile

戻り値:

Fileが示すオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合