javax.sound.sampled

クラス AudioFileFormat

java.lang.Object

javax.sound.sampled.AudioFileFormat

public class AudioFileFormat
extends Object

AudioFileFormat クラスのインスタンスは、オーディオファイルについて、ファイルタイプ、バイト数で表されるファイルの長さ、ファイルに含まれるオーディオデータのサンプルフレーム数で表される長さ、オーディオデータの形式などを記述します。

AudioSystem クラスには、オーディオファイル形式の判別、オーディオファイルからのオーディオ入力ストリームの取得、およびオーディオ入力ストリームからのオーディオファイルの書き出しを実行するメソッドが含まれます。

AudioFileFormat オブジェクトには、一式のプロパティーを組み込むことができます。1 つのプロパティーは、キーと値のペアから成ります。キーは String 型で、対応するプロパティー値は任意のオブジェクトです。プロパティーには、作成者や著作権やファイルのデュレーションなど、付加的な情報のメタデータを指定します。プロパティーはオプション情報であり、プロパティーを提供または認識するためのファイルリーダーおよびファイルライターの実装は必須ではありません。

次の表に、実装で使用される一般的なプロパティーの例を示します。

プロパティーキー	値の型	説明
"duration"	Long	マイクロ秒単位でのファイルの再生デュレーション
"author"	String	このファイルの作成者の名前
"title"	String	このファイルのタイトル
"copyright"	String	著作権メッセージ
"date"	Date	録音またはリリースの日付
"comment"	String	任意のテキスト

導入されたバージョン:

1.3

関連項目:

AudioInputStream

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	AudioFileFormat.Type Type クラスのインスタンスは、オーディオファイルの標準タイプのいずれかを表します。

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

コンストラクタ

修飾子	コンストラクタと説明
	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength) オーディオファイル形式オブジェクトを構築します。
	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength, Map<String,Object> properties) 定義された一式のプロパティーを使用して、オーディオファイル形式オブジェクトを構築します。
protected	AudioFileFormat(AudioFileFormat.Type type, int byteLength, AudioFormat format, int frameLength) オーディオファイル形式オブジェクトを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
int	getByteLength() (オーディオデータだけでなく) オーディオファイル全体のサイズをバイト単位で取得します。
AudioFormat	getFormat() オーディオファイルに含まれるオーディオデータの形式を取得します。
int	getFrameLength() サンプルフレーム数で表される、ファイルに含まれるオーディオデータの長さを取得します。
Object	getProperty(String key) キーによって指定されたプロパティー値を取得します。
AudioFileFormat.Type	getType() WAVE または AU などのオーディオファイルタイプを取得します。
Map<String,Object>	properties() 変更不可能なプロパティーのマップを取得します。
String	toString() ファイル形式の文字列表現を提供します。

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

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

コンストラクタの詳細

AudioFileFormat

protected AudioFileFormat(AudioFileFormat.Type type,
               int byteLength,
               AudioFormat format,
               int frameLength)

オーディオファイル形式オブジェクトを構築します。この protected コンストラクタは、オーディオファイルまたはサポートされているオーディオファイル形式に関する情報を返すときに、ファイル読み込みサービスを行うプロバイダによって使用されます。

パラメータ:

type - オーディオファイルのタイプ

byteLength - ファイルの長さ (バイト単位) か、AudioSystem.NOT_SPECIFIED

format - ファイルに含まれるオーディオデータの形式

frameLength - サンプルフレーム数で表されるオーディオデータの長さ、またはAudioSystem.NOT_SPECIFIED

関連項目:

getType()

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type type,
               AudioFormat format,
               int frameLength)

オーディオファイル形式オブジェクトを構築します。この public コンストラクタは、要求されたオーディオファイルのプロパティーを記述するためにアプリケーションで使用できます。

パラメータ:

type - オーディオファイルのタイプ

format - ファイルに含まれるオーディオデータの形式

frameLength - サンプルフレーム数で表されるオーディオデータの長さ、または AudioSystem.NOT_SPECIFIED

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type type,
               AudioFormat format,
               int frameLength,
               Map<String,Object> properties)

定義された一式のプロパティーを使用して、オーディオファイル形式オブジェクトを構築します。この public コンストラクタは、要求されたオーディオファイルのプロパティーを記述するためにアプリケーションで使用できます。プロパティーマップは、変更できないようにするためにコピーされます。

パラメータ:

type - オーディオファイルのタイプ

format - ファイルに含まれるオーディオデータの形式

frameLength - サンプルフレーム数で表されるオーディオデータの長さ、またはAudioSystem.NOT_SPECIFIED

properties - プロパティーを指定した Map<String,Object> オブジェクト

導入されたバージョン:

1.5

メソッドの詳細

getType

public AudioFileFormat.Type getType()

WAVE または AU などのオーディオファイルタイプを取得します。

戻り値:

オーディオファイルのタイプ

関連項目:

AudioFileFormat.Type.WAVE, AudioFileFormat.Type.AU, AudioFileFormat.Type.AIFF, AudioFileFormat.Type.AIFC, AudioFileFormat.Type.SND

getByteLength

public int getByteLength()

(オーディオデータだけでなく) オーディオファイル全体のサイズをバイト単位で取得します。

戻り値:

バイト数で表されるオーディオファイルの長さ

関連項目:

AudioSystem.NOT_SPECIFIED

getFormat

public AudioFormat getFormat()

オーディオファイルに含まれるオーディオデータの形式を取得します。

戻り値:

オーディオデータの形式

getFrameLength

public int getFrameLength()

サンプルフレーム数で表される、ファイルに含まれるオーディオデータの長さを取得します。

戻り値:

ファイル内のオーディオデータのサンプルフレーム数

関連項目:

AudioSystem.NOT_SPECIFIED

properties

public Map<String,Object> properties()

変更不可能なプロパティーのマップを取得します。プロパティーの概念の詳細は、class description の説明を参照してください。

戻り値:

すべてのプロパティーを格納する Map<String,Object> オブジェクト。プロパティーが 1 つも認識されない場合は、空のマップが返される。

導入されたバージョン:

1.5

関連項目:

getProperty(String)

getProperty

public Object getProperty(String key)

キーによって指定されたプロパティー値を取得します。プロパティーの概念の詳細は、class description の説明を参照してください。

指定したプロパティーが特定のファイル形式で定義されていない場合、このメソッドは null を返します。

パラメータ:

key - 取得したいプロパティーのキー

戻り値:

指定されたキーを持つプロパティーの値、またはプロパティーが存在しない場合は null。

導入されたバージョン:

1.5

関連項目:

properties()

toString

public String toString()

ファイル形式の文字列表現を提供します。

オーバーライド:

toString、クラス: Object

戻り値:

文字列としてのファイル形式