Класс AudioFileFormat

java.lang.Object

javax.sound.sampled.AudioFileFormat

public class AudioFileFormat extends Object

Экземпляр класса AudioFileFormat описывает аудиофайл, включая тип файла, длину файла в байтах, длину аудиоданных в файле в звуковых кадрах и формат аудиоданных.

Класс AudioSystem содержит методы для определения формата аудиофайла, получения аудиопотока ввода из аудиофайла и записи аудиофайла из аудиопотока ввода.

Объект AudioFileFormat может содержать набор свойств. Свойство — это пара ключа и значения: ключ имеет тип String, а соответствующее значение свойства является произвольным объектом. Свойства задают дополнительные метаданные (например, автора, авторские права или длительность файла). Свойства являются необязательной информацией, и реализации средств чтения и записи файлов не обязаны предоставлять или распознавать свойства.

В следующей таблице перечислены некоторые распространенные свойства, которые следует использовать в реализациях:

Свойства формата аудиофайла
Ключ свойства	Тип значения	Описание
"duration"	`Long`	длительность воспроизведения файла в микросекундах
"author"	`String`	имя автора этого файла
"title"	`String`	название этого файла
"copyright"	`String`	сообщение об авторских правах
"date"	`Date`	дата записи или выпуска
"comment"	`String`	произвольный текст

С момента:

1.3

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`AudioFileFormat.Type`	Экземпляр класса `Type` представляет один из стандартных типов аудиофайлов.

Краткое описание конструкторов

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

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

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

Модификатор	Конструктор	Описание
`protected`	Создает объект формата аудиофайла.
	Создает объект формата аудиофайла.
	Создает объект формата аудиофайла с набором заданных свойств.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getByteLength()`	Возвращает размер всего аудиофайла в байтах (а не только его аудиоданных).
`AudioFormat`	`getFormat()`	Возвращает формат аудиоданных, содержащихся в аудиофайле.
`int`	`getFrameLength()`	Возвращает длину аудиоданных, содержащихся в файле, в звуковых кадрах.
`Object`	`getProperty(String key)`	Возвращает значение свойства, заданного ключом.
`AudioFileFormat.Type`	`getType()`	Возвращает тип аудиофайла, например `WAVE` или `AU`.
`Map<String,Object>`	`properties()`	Возвращает неизменяемое отображение свойств.
`String`	`toString()`	Возвращает строковое представление формата аудиофайла.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно посредством вызова notify или interrupt, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно посредством вызова notify или interrupt, либо пока не истечет заданное время.

Подробное описание конструкторов

AudioFileFormat

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

Создает объект формата аудиофайла. Этот защищенный конструктор предназначен для использования поставщиками служб чтения файлов при возврате сведений об аудиофайле или поддерживаемых форматах аудиофайлов.

Параметры:

type — тип аудиофайла

byteLength — длина файла в байтах или AudioSystem.NOT_SPECIFIED

format — формат аудиоданных, содержащихся в файле

frameLength — длина аудиоданных в звуковых кадрах или AudioSystem.NOT_SPECIFIED

См. также:

AudioFileFormat

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

Создает объект формата аудиофайла. Это открытый конструктор может использоваться приложениями для описания свойств запрошенного аудиофайла.

Параметры:: type — тип аудиофайла; format — формат аудиоданных, содержащихся в файле; frameLength — длина аудиоданных в звуковых кадрах или AudioSystem.NOT_SPECIFIED

AudioFileFormat

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

Создает объект формата аудиофайла с набором заданных свойств. Этот открытый конструктор может использоваться приложениями для описания свойств запрошенного аудиофайла. Карта свойств будет скопирована, чтобы предотвратить ее изменение.

Параметры:: type — тип аудиофайла; format — формат аудиоданных, содержащихся в файле; frameLength — длина аудиоданных в звуковых кадрах или AudioSystem.NOT_SPECIFIED; properties — объект Map<String, Object> со свойствами
С момента:: 1.5

Подробное описание методов

getType

public AudioFileFormat.Type getType()

Возвращает тип аудиофайла, например WAVE или AU.

Возвращает:

тип аудиофайла

См. также:

getByteLength

public int getByteLength()

Возвращает размер всего аудиофайла в байтах (а не только его аудиоданных).

Возвращает:

длина аудиофайла в байтах

См. также:

getFormat

public AudioFormat getFormat()

Возвращает формат аудиоданных, содержащихся в аудиофайле.

Возвращает:: формат аудиоданных

getFrameLength

public int getFrameLength()

Возвращает длину аудиоданных, содержащихся в файле, в звуковых кадрах.

Возвращает:

количество звуковых кадров аудиоданных в файле

См. также:

properties

public Map<String,Object> properties()

Возвращает неизменяемое отображение свойств. Понятие свойств подробнее описано в class description.

Возвращает:

объект Map<String, Object>, содержащий все свойства. Если свойства не распознаны, возвращается пустое отображение.

С момента:

1.5

См. также:

getProperty

public Object getProperty(String key)

Возвращает значение свойства, заданного ключом. Понятие свойств подробнее описано в class description.

Если указанное свойство не определено для данного формата файла, этот метод возвращает null.

Параметры:

key — ключ требуемого свойства

Возвращает:

значение свойства с указанным ключом или null, если свойство не существует

С момента:

1.5

См. также:

toString

public String toString()

Возвращает строковое представление формата аудиофайла.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление формата аудиофайла

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.