モジュール java.desktop

パッケージ 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 - 入出力例外が発生した場合

NullPointerException - streamがnullの場合

関連項目:

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

getAudioFileFormat

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

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

パラメータ:

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

戻り値:

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

例外:

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

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

NullPointerException - urlがnullの場合

getAudioFileFormat

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

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

パラメータ:

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

戻り値:

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

例外:

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

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

NullPointerException - fileがnullの場合

getAudioInputStream

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

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

パラメータ:

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

戻り値:

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

例外:

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

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

NullPointerException - streamがnullの場合

関連項目:

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 - 入出力例外が発生した場合

NullPointerException - urlがnullの場合

getAudioInputStream

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

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

パラメータ:

file - AudioInputStreamを構築するFile

戻り値:

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

例外:

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

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

NullPointerException - fileがnullの場合