javax.sound.sampled

Класс AudioFormat

java.lang. Объект

javax.sound.sampled. AudioFormat

public class AudioFormat
extends Object

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

Каждой строке данных связали аудиоформат с его потоком данных. Аудиоформат источника (воспроизведение), на которое указывает строка данных, какие данные строка данных ожидают получать для вывода. Для цели (получение) строка данных аудиоформат определяет вид данных, которые могут быть считаны из строки. У звуковых файлов также есть аудиоформаты, конечно. AudioFileFormat class инкапсулирует AudioFormat в дополнение к другому, специфичной для файла информации. Точно так же AudioInputStream имеет AudioFormat.

AudioFormat class размещает много общих методов кодирования звукового файла, включая модуляцию импульсного кода (PCM), кодирование mu-закона, и законное кодирование. Эти методы кодирования предопределяются, но поставщики услуг могут создать новые типы кодирования. Кодирование, которое использует определенный формат, называет encoding поле.

В дополнение к кодированию аудиоформат включает другие свойства, которые далее определяют точное расположение данных. Они включают число каналов, демонстрационного уровня, объема выборки, порядка байтов, частоты кадров, и типа телосложения. У звуков могут быть различные числа звуковых каналов: один для моно, два для стерео. Демонстрационный уровень измеряется, сколько "снимков" (выборки) звукового давления берется в секунду на канал. (Если звук является стерео, а не моно, две выборки фактически измеряются в каждый момент времени: один для левого канала, и другого для правильного канала; однако, демонстрационный уровень все еще измеряет число на канал, таким образом, уровень является тем же самым независимо от числа каналов. Это - стандартное использование термина.) Объем выборки указывает, сколько битов используется, чтобы сохранить каждый снимок; 8 и 16 типичные значения. Для 16-разрядных выборок (или любой другой объем выборки, больше чем байт), порядок байтов важен; байты в каждой выборке располагаются или в стиле "с обратным порядком байтов" или в "с прямым порядком байтов". Для кодировок как PCM фрейм состоит из набора выборок для всех каналов в данный момент времени, и таким образом, размер фрейма (в байтах) всегда равен размеру выборки (в байтах) времена число каналов. Однако, с некоторыми другими видами кодировок фрейм может содержать пакет сжатых данных для целого ряда выборок, так же как дополнительных, недемонстрационных данных. Для таких кодировок демонстрационный уровень и объем выборки обращаются к данным после того, как это декодируется в PCM, и таким образом, они абсолютно отличаются от частоты кадров и типа телосложения.

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

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

Ключ свойства	Тип значения	Описание
"скорость передачи"	Integer	средняя скорость передачи в битах в секунду
"vbr"	Boolean	true, если файл кодируется в переменной скорости передачи (VBR)
"качество"	Integer	качество кодирования/преобразования, 1.. 100

Поставщики поставщиков услуг (плагины) поощряются искать информацию о других уже установленных свойствах в сторонних плагинах, и следовать за теми же самыми соглашениями.

С тех пор:

1.3

См. Также:

DataLine.getFormat(), AudioInputStream.getFormat(), AudioFileFormat, FormatConversionProvider

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

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

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

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected boolean	обратный порядок байтов Указывает, сохранены ли аудиоданные в порядке с прямым порядком байтов или с обратным порядком байтов.
protected int	каналы Число звуковых каналов в этом формате (1 для моно, 2 для стерео).
protected AudioFormat.Encoding	кодирование Метод аудиокодирования используется этим форматом.
protected float	frameRate Число фреймов играло или записывало в секунду для звуков, у которых есть этот формат.
protected int	frameSize Число байтов в каждом фрейме звука, у которого есть этот формат.
protected float	sampleRate Число выборок играло или записывало в секунду для звуков, у которых есть этот формат.
protected int	sampleSizeInBits Число битов в каждой выборке звука, у которого есть этот формат.

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

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

Конструктор и Описание
AudioFormat(AudioFormat.Encoding encoding, float sampleRate, int sampleSizeInBits, int channels, int frameSize, float frameRate, boolean bigEndian) Конструкции AudioFormat с данными параметрами.
AudioFormat(AudioFormat.Encoding encoding, float sampleRate, int sampleSizeInBits, int channels, int frameSize, float frameRate, boolean bigEndian, Map<String,Object> properties) Конструкции AudioFormat с данными параметрами.
AudioFormat(float sampleRate, int sampleSizeInBits, int channels, boolean signed, boolean bigEndian) Конструкции AudioFormat с линейным кодированием PCM и данными параметрами.

Сводка метода

Модификатор и Тип	Метод и Описание
int	getChannels() Получает число каналов.
AudioFormat. Кодирование	getEncoding() Получает тип кодирования для звуков в этом формате.
float	getFrameRate() Получает частоту кадров в кадрах в секунду.
int	getFrameSize() Получает тип телосложения в байтах.
Объект	getProperty(String key) Получите значение свойства, определенное ключом.
float	getSampleRate() Получает демонстрационный уровень.
int	getSampleSizeInBits() Получает размер выборки.
boolean	isBigEndian() Указывает, сохранены ли аудиоданные в или прямом порядке байтов с обратным порядком байтов.
boolean	matches(AudioFormat format) Указывает, соответствует ли этот формат определенный тот.
Map<String,Object>	properties() Получите неподдающуюся изменению карту свойств.
Строка	toString() Возвращает строку, которая описывает формат, такой как: "PCM ПОДПИСАННЫЙ моно обратный порядок байтов на 22050 Гц 16 битов".

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

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

Полевая Деталь

кодирование

protected AudioFormat.Encoding encoding

Метод аудиокодирования используется этим форматом.

sampleRate

protected float sampleRate

Число выборок играло или записывало в секунду для звуков, у которых есть этот формат.

sampleSizeInBits

protected int sampleSizeInBits

Число битов в каждой выборке звука, у которого есть этот формат.

каналы

protected int channels

Число звуковых каналов в этом формате (1 для моно, 2 для стерео).

frameSize

protected int frameSize

Число байтов в каждом фрейме звука, у которого есть этот формат.

frameRate

protected float frameRate

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

обратный порядок байтов

protected boolean bigEndian

Указывает, сохранены ли аудиоданные в порядке с прямым порядком байтов или с обратным порядком байтов.

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

AudioFormat

public AudioFormat(AudioFormat.Encoding encoding,
                   float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   int frameSize,
                   float frameRate,
                   boolean bigEndian)

Конструкции AudioFormat с данными параметрами. Кодирование определяет соглашение, используемое, чтобы представить данные. Другие параметры далее объясняются в class description.

Параметры:

encoding - метод аудиокодирования

sampleRate - число выборок в секунду

sampleSizeInBits - число битов в каждой выборке

channels - число каналов (1 для моно, 2 для стерео, и так далее)

frameSize - число байтов в каждом фрейме

frameRate - число кадров в секунду

bigEndian - указывает, хранятся ли данные для единственной выборки в обратном порядке байтов (false прямой порядок байтов средств)

AudioFormat

public AudioFormat(AudioFormat.Encoding encoding,
                   float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   int frameSize,
                   float frameRate,
                   boolean bigEndian,
                   Map<String,Object> properties)

Конструкции AudioFormat с данными параметрами. Кодирование определяет соглашение, используемое, чтобы представить данные. Другие параметры далее объясняются в class description.

Параметры:

encoding - метод аудиокодирования

sampleRate - число выборок в секунду

sampleSizeInBits - число битов в каждой выборке

channels - число каналов (1 для моно, 2 для стерео, и так далее)

frameSize - число байтов в каждом фрейме

frameRate - число кадров в секунду

bigEndian - указывает, хранятся ли данные для единственной выборки в обратном порядке байтов (false прямой порядок байтов средств)

properties - a Map<String,Object> объект, содержащий свойства формата

С тех пор:

1.5

AudioFormat

public AudioFormat(float sampleRate,
                   int sampleSizeInBits,
                   int channels,
                   boolean signed,
                   boolean bigEndian)

Конструкции AudioFormat с линейным кодированием PCM и данными параметрами. Тип телосложения устанавливается в число байтов, требуемых содержать одну выборку от каждого канала, и частота кадров устанавливается в демонстрационный уровень.

Параметры:

sampleRate - число выборок в секунду

sampleSizeInBits - число битов в каждой выборке

channels - число каналов (1 для моно, 2 для стерео, и так далее)

signed - указывает, подписываются ли данные или без знака

bigEndian - указывает, хранятся ли данные для единственной выборки в обратном порядке байтов (false прямой порядок байтов средств)

Деталь метода

getEncoding

public AudioFormat.Encoding getEncoding()

Получает тип кодирования для звуков в этом формате.

Возвраты:

тип кодирования

См. Также:

AudioFormat.Encoding.PCM_SIGNED, AudioFormat.Encoding.PCM_UNSIGNED, AudioFormat.Encoding.ULAW, AudioFormat.Encoding.ALAW

getSampleRate

public float getSampleRate()

Получает демонстрационный уровень. Для сжатых форматов возвращаемое значение является демонстрационным уровнем несжатых аудиоданных. Когда этот AudioFormat используется для запросов (например. AudioSystem.isConversionSupported) или возможности (например. DataLine.Info.getFormats), демонстрационный уровень AudioSystem.NOT_SPECIFIED средства, что любой демонстрационный уровень является приемлемым. AudioSystem.NOT_SPECIFIED также возвращается, когда демонстрационный уровень не определяется для этого аудиоформата.

Возвраты:

число выборок в секунду, или AudioSystem.NOT_SPECIFIED

См. Также:

getFrameRate(), AudioSystem.NOT_SPECIFIED

getSampleSizeInBits

public int getSampleSizeInBits()

Получает размер выборки. Для сжатых форматов возвращаемое значение является объемом выборки несжатых аудиоданных. Когда этот AudioFormat используется для запросов (например. AudioSystem.isConversionSupported) или возможности (например. DataLine.Info.getFormats), объем выборки AudioSystem.NOT_SPECIFIED средства, что любой объем выборки является приемлемым. AudioSystem.NOT_SPECIFIED также возвращается, когда объем выборки не определяется для этого аудиоформата.

Возвраты:

число битов в каждой выборке, или AudioSystem.NOT_SPECIFIED

См. Также:

getFrameSize(), AudioSystem.NOT_SPECIFIED

getChannels

public int getChannels()

Получает число каналов. Когда этот AudioFormat используется для запросов (например. AudioSystem.isConversionSupported) или возможности (например. DataLine.Info.getFormats), возвращаемое значение AudioSystem.NOT_SPECIFIED средства, что любое (положительное) число каналов является приемлемым.

Возвраты:

Число каналов (1 для моно, 2 для стерео, и т.д.), или AudioSystem.NOT_SPECIFIED

См. Также:

AudioSystem.NOT_SPECIFIED

getFrameSize

public int getFrameSize()

Получает тип телосложения в байтах. Когда этот AudioFormat используется для запросов (например. AudioSystem.isConversionSupported) или возможности (например. DataLine.Info.getFormats), тип телосложения AudioSystem.NOT_SPECIFIED средства, что любой тип телосложения является приемлемым. AudioSystem.NOT_SPECIFIED также возвращается, когда тип телосложения не определяется для этого аудиоформата.

Возвраты:

число байтов на фрейм, или AudioSystem.NOT_SPECIFIED

См. Также:

getSampleSizeInBits(), AudioSystem.NOT_SPECIFIED

getFrameRate

public float getFrameRate()

Получает частоту кадров в кадрах в секунду. Когда этот AudioFormat используется для запросов (например. AudioSystem.isConversionSupported) или возможности (например. DataLine.Info.getFormats), частота кадров AudioSystem.NOT_SPECIFIED средства, что любая частота кадров является приемлемой. AudioSystem.NOT_SPECIFIED также возвращается, когда частота кадров не определяется для этого аудиоформата.

Возвраты:

число кадров в секунду, или AudioSystem.NOT_SPECIFIED

См. Также:

getSampleRate(), AudioSystem.NOT_SPECIFIED

isBigEndian

public boolean isBigEndian()

Указывает, сохранены ли аудиоданные в или прямом порядке байтов с обратным порядком байтов. Если объем выборки составляет не больше чем один байт, возвращаемое значение не важно.

Возвраты:

true если данные хранятся в обратном порядке байтов, false если прямой порядок байтов

свойства

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()

соответствия

public boolean matches(AudioFormat format)

Указывает, соответствует ли этот формат определенный тот. Чтобы соответствовать, у двух форматов должны быть то же самое кодирование, и непротиворечивые значения числа каналов, демонстрационного уровня, объема выборки, частоты кадров, и типа телосложения. Значения свойства являются непротиворечивыми, если они равны, или у указанного формата есть значение свойства AudioSystem.NOT_SPECIFIED. Порядок байтов (или прямой порядок байтов с обратным порядком байтов) должен быть тем же самым, если объем выборки больше чем один байт.

Параметры:

format - отформатируйте, чтобы протестировать на соответствие

Возвраты:

true если этот формат соответствует определенный тот, false иначе.

toString

public String toString()

Возвращает строку, которая описывает формат, такой как: "PCM ПОДПИСАННЫЙ моно обратный порядок байтов на 22050 Гц 16 битов". Содержание строки может измениться между реализациями Звука Java.

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

toString в class Object

Возвраты:

строка, которая описывает параметры формата