public class AudioFileFormat extends Object
AudioFileFormat
クラスのインスタンスは、オーディオ・ファイルについて、ファイル・タイプ、バイト数で表されるファイルの長さ、ファイルに含まれるオーディオ・データのサンプル・フレーム数で表される長さ、オーディオ・データの形式などを記述します。
クラスには、オーディオ・ファイル形式の判別、オーディオ・ファイルからのオーディオ入力ストリームの取得、およびオーディオ入力ストリームからのオーディオ・ファイルの書出しを実行するメソッドが含まれます。
AudioSystem
AudioFileFormat
オブジェクトには、一式のプロパティを組み込むことができます。 1つのプロパティは、キーと値のペアから成ります。キーはString
型で、対応するプロパティ値は任意のオブジェクトです。 プロパティには、作成者や著作権やファイルのデュレーションなど、付加的な情報のメタデータを指定します。 プロパティはオプション情報であり、プロパティを提供または認識するためのファイル・リーダーおよびファイル・ライターの実装は必須ではありません。
次の表に、実装で使用される一般的なプロパティの例を示します。
プロパティ・キー | 値の型 | 説明 |
---|---|---|
"duration" | Long |
マイクロ秒単位でのファイルの再生デュレーション |
"author" | String |
このファイルの作成者の名前 |
"title" | String |
このファイルのタイトル |
"copyright" | String |
著作権メッセージ |
"date" | Date |
録音またはリリースの日付 |
"comment" | String |
任意のテキスト |
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() |
ファイル形式の文字列表現を提供します。
|
protected AudioFileFormat(AudioFileFormat.Type type, int byteLength, AudioFormat format, int frameLength)
type
- オーディオ・ファイルのタイプbyteLength
- ファイルの長さ(バイト単位)か、AudioSystem.NOT_SPECIFIED
format
- ファイルに含まれるオーディオ・データの形式frameLength
- サンプル・フレーム数で表されるオーディオ・データの長さ、またはAudioSystem.NOT_SPECIFIED
getType()
public AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength)
type
- オーディオ・ファイルのタイプformat
- ファイルに含まれるオーディオ・データの形式frameLength
- サンプル・フレーム数で表されるオーディオ・データの長さ、またはAudioSystem.NOT_SPECIFIED
public AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength, Map<String,Object> properties)
type
- オーディオ・ファイルのタイプformat
- ファイルに含まれるオーディオ・データの形式frameLength
- サンプル・フレーム数で表されるオーディオ・データの長さ、またはAudioSystem.NOT_SPECIFIED
properties
- プロパティを指定したMap<String,Object>
オブジェクトpublic AudioFileFormat.Type getType()
WAVE
またはAU
などのオーディオ・ファイル・タイプを取得します。AudioFileFormat.Type.WAVE
, AudioFileFormat.Type.AU
, AudioFileFormat.Type.AIFF
, AudioFileFormat.Type.AIFC
, AudioFileFormat.Type.SND
public int getByteLength()
AudioSystem.NOT_SPECIFIED
public AudioFormat getFormat()
public int getFrameLength()
AudioSystem.NOT_SPECIFIED
public Map<String,Object> properties()
class description
の説明を参照してください。 Map<String,Object>
オブジェクト。 プロパティが1つも認識されない場合は、空のマップが返される。 getProperty(String)
public Object getProperty(String key)
class description
の説明を参照してください。
指定したプロパティが特定のファイル形式で定義されていない場合、このメソッドはnull
を返します。
key
- 取得したいプロパティのキーnull
。properties()
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。