JavaTM 2 Platform
Standard Ed. 5.0

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

JavaTM 2 Platform
Standard Ed. 5.0

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

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