AudioFormat (Платформа Java SE 7)

java.lang. Объект
- javax.sound.sampled. AudioFormat

public class AudioFormat
extends Object

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

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

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

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

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

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

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

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

С тех пор:: 1.3
См. Также:: DataLine.getFormat(), AudioInputStream.getFormat(), AudioFileFormat, FormatConversionProvider

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

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

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

Поля
Модификатор и Тип	Поле и Описание
`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 битов".

Методы 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 в классе Object
    
    Возвраты:
    строка, которая описывает параметры формата

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс AudioFormat

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

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

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

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

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

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

кодирование

sampleRate

sampleSizeInBits

каналы

frameSize

frameRate

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

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

AudioFormat

AudioFormat

AudioFormat

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

getEncoding

getSampleRate

getSampleSizeInBits

getChannels

getFrameSize

getFrameRate

isBigEndian

свойства

getProperty

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

toString