javax.sound.sampled

Класс AudioFileFormat

java.lang. Объект

javax.sound.sampled. AudioFileFormat

public class AudioFileFormat
extends Object

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

AudioSystem class включает методы для того, чтобы определить формат аудиофайла, получая поток аудиовхода из аудиофайла, и пишущий аудиофайл из потока аудиовхода.

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

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

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

С тех пор:

1.3

См. Также:

AudioInputStream

Вложенная Сводка Класса

Вложенные Классы

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

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
	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() Получает продолжительность аудиоданных, содержавшихся в файле, выраженном в демонстрационных фреймах.
Объект	getProperty(String key) Получите значение свойства, определенное ключом.
AudioFileFormat. Ввести	getType() Получает тип аудиофайла, такой как WAVE или AU.
Map<String,Object>	properties() Получите неподдающуюся изменению карту свойств.
Строка	toString() Обеспечивает строковое представление формата файла.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

AudioFileFormat

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

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

Параметры:

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

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

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

frameLength - длина аудиоданных в демонстрационных фреймах, или AudioSystem.NOT_SPECIFIED

См. Также:

getType()

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 - a 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

свойства

public Map<String,Object> properties()

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

Возвраты:

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

С тех пор:

1.5

См. Также:

getProperty(String)

getProperty

public Object getProperty(String key)

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

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

Параметры:

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

Возвраты:

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

С тех пор:

1.5

См. Также:

properties()

toString

public String toString()

Обеспечивает строковое представление формата файла.

Переопределения:

toString в class Object

Возвраты:

формат файла как строка