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