javax.sound.sampled

Класс AudioSystem

java.lang. Объект

javax.sound.sampled. AudioSystem

public class AudioSystem
extends Object

AudioSystem class действует как точка входа к ресурсам выбранной аудиосистемы. Этот class позволяет Вам запрашивать и получать доступ к микшерам, которые устанавливаются на системе. AudioSystem включает много методов для того, чтобы преобразовать аудиоданные между различными форматами, и для того, чтобы преобразовать между аудиофайлами и потоками. Это также обеспечивает метод для того, чтобы он получил a Line непосредственно от AudioSystem не имея дело явно с микшерами.

Свойства могут использоваться, чтобы определить микшер значения по умолчанию для определенных типов строки. И системные свойства и файл свойств рассматривают. sound.properties файл свойств читается из специфичного для реализации расположения (обычно, это lib каталог в каталоге установки Java). Если свойство существует и как системное свойство и в файле свойств, системное свойство имеет приоритет. Если ни один не определяется, подходящее значение по умолчанию выбирается среди доступных устройств. Синтаксис файла свойств определяется в Properties.load. Следующая таблица приводит доступные ключи свойства и какие методы рассматривают их:

Ключ свойства	Интерфейс	Метод (ы), на который влияют,
javax.sound.sampled.Clip	Clip	getLine(javax.sound.sampled.Line.Info), getClip()
javax.sound.sampled.Port	Port	getLine(javax.sound.sampled.Line.Info)
javax.sound.sampled.SourceDataLine	SourceDataLine	getLine(javax.sound.sampled.Line.Info), getSourceDataLine(javax.sound.sampled.AudioFormat)
javax.sound.sampled.TargetDataLine	TargetDataLine	getLine(javax.sound.sampled.Line.Info), getTargetDataLine(javax.sound.sampled.AudioFormat)

Значение свойства состоит из провайдера имя class и имя микшера, разделенное знаком "диез" ("#"). Провайдер имя class является полностью определенным именем бетона mixer provider class. Имя микшера является соответствующим против String возвращенный getName метод Mixer.Info. Или имя class, или имя микшера может быть опущено. Если только имя class определяется, запаздывающий знак "диез" дополнительный.

Если провайдер, class определяется, и это может быть successully, полученный от установленных провайдеров, списка Mixer.Info объекты получаются от провайдера. Иначе, или когда эти микшеры не обеспечивают последующее соответствие, список получается от getMixerInfo() содержать всех доступных Mixer.Info объекты.

Если имя микшера определяется, получающийся список Mixer.Info объекты ищутся: первый с соответствующим именем, и чей Mixer обеспечивает соответствующий линейный интерфейс, будет возвращен. Если никакое соответствие Mixer.Info объект находится, или имя микшера не определяется, первый микшер от получающегося списка, который обеспечивает соответствующий линейный интерфейс, будет возвращен. Например, свойство javax.sound.sampled.Clip со значением "com.sun.media.sound.MixerProvider#SunClip" будет иметь следующие последствия когда getLine вызывается, запрашивая a Clip экземпляр: если class com.sun.media.sound.MixerProvider существует в списке установленных провайдеров микшера, первого Clip от первого микшера с именем "SunClip" будет возвращен. Если это не может быть найдено, первое Clip от первого микшера указанного провайдера будет возвращен, независимо от имени. Если нет ни одного, первого Clip сначала Mixer с именем "SunClip" в списке всех микшеров (как возвращено getMixerInfo) будет возвращен, или, если не найденный, первое Clip из первого Mixerэто может быть найдено в списке всех микшеров, возвращается. Если это перестало работать, также, IllegalArgumentException бросается.

С тех пор:

1.3

См. Также:

AudioFormat, AudioInputStream, Mixer, Line, Line.Info

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

Поля

Модификатор и Тип	Поле и Описание
static int	NOT_SPECIFIED Целое число, которое обозначает неизвестное числовое значение.

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

Модификатор и Тип	Метод и Описание
static AudioFileFormat	getAudioFileFormat(File file) Получает формат аудиофайла указанного File.
static AudioFileFormat	getAudioFileFormat(InputStream stream) Получает формат аудиофайла обеспеченного входного потока.
static AudioFileFormat	getAudioFileFormat(URL url) Получает формат аудиофайла указанного URL.
static AudioFileFormat.Type[]	getAudioFileTypes() Получает типы файла, для которых поддержка записи файла оказывается системой.
static AudioFileFormat.Type[]	getAudioFileTypes(AudioInputStream stream) Получает типы файла, которые система может записать из определенного потока аудиовхода.
static AudioInputStream	getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream) Получает поток аудиовхода обозначенного кодирования, преобразовывая обеспеченный поток аудиовхода.
static AudioInputStream	getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream) Получает поток аудиовхода обозначенного формата, преобразовывая обеспеченный поток аудиовхода.
static AudioInputStream	getAudioInputStream(File file) Получает поток аудиовхода из обеспеченного File.
static AudioInputStream	getAudioInputStream(InputStream stream) Получает поток аудиовхода из обеспеченного входного потока.
static AudioInputStream	getAudioInputStream(URL url) Получает поток аудиовхода из обеспеченного URL.
static Clip	getClip() Получает клип, который может использоваться для того, чтобы воспроизвести аудиофайл или аудиопоток.
static Clip	getClip(Mixer.Info mixerInfo) Получает клип из указанного микшера, который может использоваться для того, чтобы воспроизвести аудиофайл или аудиопоток.
static Line	getLine(Line.Info info) Получает строку, которая соответствует описание в указанном Line.Info объект.
static Mixer	getMixer(Mixer.Info info) Получает требуемый аудио микшер.
static Mixer.Info[]	getMixerInfo() Получает массив объектов информации микшера, который представляет набор аудио микшеров, которые в настоящий момент устанавливаются на системе.
static SourceDataLine	getSourceDataLine(AudioFormat format) Получает строку исходных данных, которая может использоваться для того, чтобы воспроизвести аудиоданные в формате, определенном AudioFormat объект.
static SourceDataLine	getSourceDataLine(AudioFormat format, Mixer.Info mixerinfo) Получает строку исходных данных, которая может использоваться для того, чтобы воспроизвести аудиоданные в формате, определенном AudioFormat объект, обеспеченный микшером, определенным Mixer.Info объект.
static Line.Info[]	getSourceLineInfo(Line.Info info) Получает информацию обо всех исходных строках определенного типа, которые поддерживаются установленными микшерами.
static TargetDataLine	getTargetDataLine(AudioFormat format) Получает целевую строку данных, которая может использоваться для того, чтобы записать аудиоданные в формате, определенном AudioFormat объект.
static TargetDataLine	getTargetDataLine(AudioFormat format, Mixer.Info mixerinfo) Получает целевую строку данных, которая может использоваться для того, чтобы записать аудиоданные в формате, определенном AudioFormat объект, обеспеченный микшером, определенным Mixer.Info объект.
static AudioFormat.Encoding[]	getTargetEncodings(AudioFormat.Encoding sourceEncoding) Получает кодировки, которые система может получить из потока аудиовхода с указанным кодированием, используя набор установленных преобразователей формата.
static AudioFormat.Encoding[]	getTargetEncodings(AudioFormat sourceFormat) Получает кодировки, которые система может получить из потока аудиовхода с указанным форматом, используя набор установленных преобразователей формата.
static AudioFormat[]	getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat) Получает форматы, у которых есть определенное кодирование и что система может получить из потока указанного формата, используя набор установленных преобразователей формата.
static Line.Info[]	getTargetLineInfo(Line.Info info) Получает информацию обо всех целевых строках определенного типа, которые поддерживаются установленными микшерами.
static boolean	isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat) Указывает, может ли поток аудиовхода указанного кодирования быть получен из потока аудиовхода, у которого есть указанный формат.
static boolean	isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat) Указывает, может ли поток аудиовхода указанного формата быть получен из потока аудиовхода другого указанного формата.
static boolean	isFileTypeSupported(AudioFileFormat.Type fileType) Указывает, оказывается ли поддержка записи файла указанного типа файла системой.
static boolean	isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream) Указывает, может ли аудиофайл указанного типа файла быть записан из обозначенного потока аудиовхода.
static boolean	isLineSupported(Line.Info info) Указывает, поддерживает ли система какие-либо строки, которые соответствуют указанное Line.Info объект.
static int	write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) Пишет поток байтов, представляющих аудиофайл указанного типа файла к внешнему обеспеченному файлу.
static int	write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) Пишет поток байтов, представляющих аудиофайл указанного типа файла к обеспеченному потоку вывода.

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

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

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

NOT_SPECIFIED

public static final int NOT_SPECIFIED

Целое число, которое обозначает неизвестное числовое значение. Это значение является подходящим только для подписанных количеств, которые обычно не берут отрицательные величины. Примеры включают размеры файла, типы телосложения, буферизуют размеры, и демонстрационные уровни. Много конструкторов Звука Java принимают значение NOT_SPECIFIED для таких параметров. Другие методы могут также принять или возвратить это значение, как задокументировано.

См. Также:

Постоянные Значения полей

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

getMixerInfo

public static Mixer.Info[] getMixerInfo()

Получает массив объектов информации микшера, который представляет набор аудио микшеров, которые в настоящий момент устанавливаются на системе.

Возвраты:

массив информации возражает для в настоящий момент установленных микшеров. Если никакие микшеры не доступны на системе, массив длины 0 возвращается.

См. Также:

getMixer(javax.sound.sampled.Mixer.Info)

getMixer

public static Mixer getMixer(Mixer.Info info)

Получает требуемый аудио микшер.

Параметры:

info - a Mixer.Info объект, представляющий требуемый микшер, или null для микшера системного значения по умолчанию

Возвраты:

требуемый микшер

Броски:

SecurityException - если требуемый микшер недоступен из-за ограничений безопасности

IllegalArgumentException - если объект информации не представляет микшер, установленный на системе

См. Также:

getMixerInfo()

getSourceLineInfo

public static Line.Info[] getSourceLineInfo(Line.Info info)

Получает информацию обо всех исходных строках определенного типа, которые поддерживаются установленными микшерами.

Параметры:

info - a Line.Info объект, который определяет вид строк, о которых требуют информацию

Возвраты:

массив Line.Info объекты, описывающие исходные строки, соответствующие тип, требуют. Если никакие исходные строки соответствия не поддерживаются, массив длины 0 возвращается.

См. Также:

Mixer.getSourceLineInfo(Line.Info)

getTargetLineInfo

public static Line.Info[] getTargetLineInfo(Line.Info info)

Получает информацию обо всех целевых строках определенного типа, которые поддерживаются установленными микшерами.

Параметры:

info - a Line.Info объект, который определяет вид строк, о которых требуют информацию

Возвраты:

массив Line.Info объекты, описывающие целевые строки, соответствующие тип, требуют. Если никакие целевые строки соответствия не поддерживаются, массив длины 0 возвращается.

См. Также:

Mixer.getTargetLineInfo(Line.Info)

isLineSupported

public static boolean isLineSupported(Line.Info info)

Указывает, поддерживает ли система какие-либо строки, которые соответствуют указанное Line.Info объект. Строка поддерживается, если какой-либо установленный микшер поддерживает ее.

Параметры:

info - a Line.Info объект, описывающий строку, для которой запрашивается поддержка

Возвраты:

true если по крайней мере одна строка соответствия поддерживается, иначе false

См. Также:

Mixer.isLineSupported(Line.Info)

getLine

public static Line getLine(Line.Info info)
                    throws LineUnavailableException

Получает строку, которая соответствует описание в указанном Line.Info объект.

Если a DataLine требуется, и info экземпляр DataLine.Info определяя по крайней мере один полностью определенный аудиоформат, последний будет использоваться в качестве формата значения по умолчанию возвращенного DataLine.

Если системные свойства javax.sound.sampled.Clip, javax.sound.sampled.Port, javax.sound.sampled.SourceDataLine и javax.sound.sampled.TargetDataLine определяются или они определяются в файле "sound.properties", они используются, чтобы получить строки значения по умолчанию. Для получения дополнительной информации обратитесь к class description. Если соответствующее свойство не устанавливается, или микшер, который требуют в свойстве, не устанавливается или не обеспечивает требуемую строку, все установленные микшеры запрашиваются для требуемого типа строки. Строка будет возвращена из первого микшера, обеспечивающего требуемый тип строки.

Параметры:

info - a Line.Info объект, описывающий требуемый вид строки

Возвраты:

строка требуемого вида

Броски:

LineUnavailableException - если строка соответствия не доступна из-за ограничений ресурса

SecurityException - если строка соответствия не доступна из-за ограничений безопасности

IllegalArgumentException - если система не поддерживает по крайней мере одну строку, соответствующую указанное Line.Info объект через любой установленный микшер

getClip

public static Clip getClip()
                    throws LineUnavailableException

Получает клип, который может использоваться для того, чтобы воспроизвести аудиофайл или аудиопоток. Возвращенный клип будет обеспечен системным микшером значения по умолчанию, или, если не возможный, любым другим микшером, установленным в системе, которая поддерживает a Clip объект.

Возвращенный клип должен быть открыт с open(AudioFormat) или open(AudioInputStream) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Если системное свойство javax.sound.sampled.Clip определяется или это определяется в файле "sound.properties", это используется, чтобы получить клип значения по умолчанию. Для получения дополнительной информации обратитесь к class description.

Возвраты:

требуемый объект клипа

Броски:

LineUnavailableException - если объект клипа не доступен из-за ограничений ресурса

SecurityException - если объект клипа не доступен из-за ограничений безопасности

IllegalArgumentException - если система не поддерживает по крайней мере один экземпляр клипа через какой-либо установленный микшер

С тех пор:

1.5

См. Также:

getClip(Mixer.Info)

getClip

public static Clip getClip(Mixer.Info mixerInfo)
                    throws LineUnavailableException

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

Возвращенный клип должен быть открыт с open(AudioFormat) или open(AudioInputStream) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Параметры:

mixerInfo - a Mixer.Info объект, представляющий требуемый микшер, или null для микшера системного значения по умолчанию

Возвраты:

объект клипа от указанного микшера

Броски:

LineUnavailableException - если клип не доступен от этого микшера из-за ограничений ресурса

SecurityException - если клип не доступен от этого микшера из-за ограничений безопасности

IllegalArgumentException - если система не поддерживает по крайней мере один клип через указанный микшер

С тех пор:

1.5

См. Также:

getClip()

getSourceDataLine

public static SourceDataLine getSourceDataLine(AudioFormat format)
                                        throws LineUnavailableException

Получает строку исходных данных, которая может использоваться для того, чтобы воспроизвести аудиоданные в формате, определенном AudioFormat объект. Возвращенная строка будет обеспечена системным микшером значения по умолчанию, или, если не возможный, любым другим микшером, установленным в системе, которая поддерживает соответствие SourceDataLine объект.

Возвращенная строка должна быть открыта с open(AudioFormat) или open(AudioFormat, int) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Возвращенный SourceDataLine's аудиоформат значения по умолчанию будет инициализирован с format.

Если системное свойство javax.sound.sampled.SourceDataLine определяется или это определяется в файле "sound.properties", это используется, чтобы получить строку исходных данных значения по умолчанию. Для получения дополнительной информации обратитесь к class description.

Параметры:

format - AudioFormat объект, определяющий поддерживаемый аудиоформат возвращенной строки, или null для любого аудиоформата

Возвраты:

требуемый SourceDataLine объект

Броски:

LineUnavailableException - если соответствующая строка исходных данных не доступна из-за ограничений ресурса

SecurityException - если соответствующая строка исходных данных не доступна из-за ограничений безопасности

IllegalArgumentException - если система не поддерживает по крайней мере одну строку исходных данных, поддерживающую указанный аудиоформат через какой-либо установленный микшер

С тех пор:

1.5

См. Также:

getSourceDataLine(AudioFormat, Mixer.Info)

getSourceDataLine

public static SourceDataLine getSourceDataLine(AudioFormat format,
                                               Mixer.Info mixerinfo)
                                        throws LineUnavailableException

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

Возвращенная строка должна быть открыта с open(AudioFormat) или open(AudioFormat, int) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Возвращенный SourceDataLine's аудиоформат значения по умолчанию будет инициализирован с format.

Параметры:

format - AudioFormat объект, определяющий поддерживаемый аудиоформат возвращенной строки, или null для любого аудиоформата

mixerinfo - a Mixer.Info объект, представляющий требуемый микшер, или null для микшера системного значения по умолчанию

Возвраты:

требуемый SourceDataLine объект

Броски:

LineUnavailableException - если соответствующая строка исходных данных не доступна от указанного микшера из-за ограничений ресурса

SecurityException - если соответствующая строка исходных данных не доступна от указанного микшера из-за ограничений безопасности

IllegalArgumentException - если указанный микшер не поддерживает по крайней мере одну строку исходных данных, поддерживающую указанный аудиоформат

С тех пор:

1.5

См. Также:

getSourceDataLine(AudioFormat)

getTargetDataLine

public static TargetDataLine getTargetDataLine(AudioFormat format)
                                        throws LineUnavailableException

Получает целевую строку данных, которая может использоваться для того, чтобы записать аудиоданные в формате, определенном AudioFormat объект. Возвращенная строка будет обеспечена системным микшером значения по умолчанию, или, если не возможный, любым другим микшером, установленным в системе, которая поддерживает соответствие TargetDataLine объект.

Возвращенная строка должна быть открыта с open(AudioFormat) или open(AudioFormat, int) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Возвращенный TargetDataLine's аудиоформат значения по умолчанию будет инициализирован с format.

Если системное свойство javax.sound.sampled.TargetDataLine определяется или это определяется в файле "sound.properties", это используется, чтобы получить целевую строку данных значения по умолчанию. Для получения дополнительной информации обратитесь к class description.

Параметры:

format - AudioFormat объект, определяющий поддерживаемый аудиоформат возвращенной строки, или null для любого аудиоформата

Возвраты:

требуемый TargetDataLine объект

Броски:

LineUnavailableException - если соответствующая целевая строка данных не доступна из-за ограничений ресурса

SecurityException - если соответствующая целевая строка данных не доступна из-за ограничений безопасности

IllegalArgumentException - если система не поддерживает по крайней мере одну целевую строку данных, поддерживающую указанный аудиоформат через какой-либо установленный микшер

С тех пор:

1.5

См. Также:

getTargetDataLine(AudioFormat, Mixer.Info), AudioPermission

getTargetDataLine

public static TargetDataLine getTargetDataLine(AudioFormat format,
                                               Mixer.Info mixerinfo)
                                        throws LineUnavailableException

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

Возвращенная строка должна быть открыта с open(AudioFormat) или open(AudioFormat, int) метод.

Это - высокоуровневый метод, который использует getMixer и getLine внутренне.

Возвращенный TargetDataLine's аудиоформат значения по умолчанию будет инициализирован с format.

Параметры:

format - AudioFormat объект, определяющий поддерживаемый аудиоформат возвращенной строки, или null для любого аудиоформата

mixerinfo - a Mixer.Info объект, представляющий требуемый микшер, или null для микшера системного значения по умолчанию

Возвраты:

требуемый TargetDataLine объект

Броски:

LineUnavailableException - если соответствующая целевая строка данных не доступна от указанного микшера из-за ограничений ресурса

SecurityException - если соответствующая целевая строка данных не доступна от указанного микшера из-за ограничений безопасности

IllegalArgumentException - если указанный микшер не поддерживает по крайней мере одну целевую строку данных, поддерживающую указанный аудиоформат

С тех пор:

1.5

См. Также:

getTargetDataLine(AudioFormat), AudioPermission

getTargetEncodings

public static AudioFormat.Encoding[] getTargetEncodings(AudioFormat.Encoding sourceEncoding)

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

Параметры:

sourceEncoding - кодирование, для которого запрашивается поддержка преобразования

Возвраты:

массив кодировок. Если sourceEncodingне поддерживается, массив длины 0 возвращается. Иначе, у массива будет длина по крайней мере 1, представляя sourceEncoding (никакое преобразование).

getTargetEncodings

public static AudioFormat.Encoding[] getTargetEncodings(AudioFormat sourceFormat)

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

Параметры:

sourceFormat - аудиоформат, для которого запрашивается преобразование

Возвраты:

массив кодировок. Если sourceFormatне поддерживается, массив длины 0 возвращается. Иначе, у массива будет длина по крайней мере 1, представляя кодирование sourceFormat (никакое преобразование).

isConversionSupported

public static boolean isConversionSupported(AudioFormat.Encoding targetEncoding,
                                            AudioFormat sourceFormat)

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

Параметры:

targetEncoding - требуемое кодирование после преобразования

sourceFormat - аудиоформат перед преобразованием

Возвраты:

true если преобразование поддерживается, иначе false

getAudioInputStream

public static AudioInputStream getAudioInputStream(AudioFormat.Encoding targetEncoding,
                                                   AudioInputStream sourceStream)

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

Параметры:

targetEncoding - требуемое кодирование после преобразования

sourceStream - поток, который будет преобразован

Возвраты:

поток аудиовхода обозначенного кодирования

Броски:

IllegalArgumentException - если преобразование не поддерживается

См. Также:

getTargetEncodings(AudioFormat.Encoding), getTargetEncodings(AudioFormat), isConversionSupported(AudioFormat.Encoding, AudioFormat), getAudioInputStream(AudioFormat, AudioInputStream)

getTargetFormats

public static AudioFormat[] getTargetFormats(AudioFormat.Encoding targetEncoding,
                                             AudioFormat sourceFormat)

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

Параметры:

targetEncoding - требуемое кодирование после преобразования

sourceFormat - аудиоформат перед преобразованием

Возвраты:

массив форматов. Если никакие форматы указанного кодирования не поддерживаются, массив длины 0 возвращается.

isConversionSupported

public static boolean isConversionSupported(AudioFormat targetFormat,
                                            AudioFormat sourceFormat)

Указывает, может ли поток аудиовхода указанного формата быть получен из потока аудиовхода другого указанного формата.

Параметры:

targetFormat - требуемый аудиоформат после преобразования

sourceFormat - аудиоформат перед преобразованием

Возвраты:

true если преобразование поддерживается, иначе false

getAudioInputStream

public static AudioInputStream getAudioInputStream(AudioFormat targetFormat,
                                                   AudioInputStream sourceStream)

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

Параметры:

targetFormat - требуемый аудиоформат после преобразования

sourceStream - поток, который будет преобразован

Возвраты:

поток аудиовхода обозначенного формата

Броски:

IllegalArgumentException - если преобразование не поддерживается #see #getTargetEncodings (Аудиоформат)

См. Также:

getTargetFormats(AudioFormat.Encoding, AudioFormat), isConversionSupported(AudioFormat, AudioFormat), getAudioInputStream(AudioFormat.Encoding, AudioInputStream)

getAudioFileFormat

public static AudioFileFormat getAudioFileFormat(InputStream stream)
                                          throws UnsupportedAudioFileException,
                                                 IOException

Получает формат аудиофайла обеспеченного входного потока. Поток должен указать на допустимые данные аудиофайла. Реализация этого метода может потребовать, чтобы многократные синтаксические анализаторы исследовали поток, чтобы определить, поддерживают ли они это. Эти синтаксические анализаторы должны быть в состоянии отметить поток, считать достаточно многие данные, чтобы определить, поддерживают ли они поток, и, в противном случае сбрасывают указатель чтения потока на его исходную позицию. Если входной поток не поддерживает эти операции, этот метод может перестать работать с IOException.

Параметры:

stream - входной поток, из которого должна быть извлечена информация о формате файла

Возвраты:

AudioFileFormat объект, описывающий формат аудиофайла потока

Броски:

UnsupportedAudioFileException - если поток не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода/вывода происходит

См. Также:

InputStream.markSupported(), InputStream.mark(int)

getAudioFileFormat

public static AudioFileFormat getAudioFileFormat(URL url)
                                          throws UnsupportedAudioFileException,
                                                 IOException

Получает формат аудиофайла указанного URL. URL должен указать на допустимые данные аудиофайла.

Параметры:

url - URL, из которого должна быть извлечена информация о формате файла

Возвраты:

AudioFileFormat объект, описывающий формат аудиофайла

Броски:

UnsupportedAudioFileException - если URL не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода/вывода происходит

getAudioFileFormat

public static AudioFileFormat getAudioFileFormat(File file)
                                          throws UnsupportedAudioFileException,
                                                 IOException

Получает формат аудиофайла указанного File. File должен указать на допустимые данные аудиофайла.

Параметры:

file - File из которого должна быть извлечена информация о формате файла

Возвраты:

AudioFileFormat объект, описывающий формат аудиофайла

Броски:

UnsupportedAudioFileException - если File не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода-вывода происходит

getAudioInputStream

public static AudioInputStream getAudioInputStream(InputStream stream)
                                            throws UnsupportedAudioFileException,
                                                   IOException

Получает поток аудиовхода из обеспеченного входного потока. Поток должен указать на допустимые данные аудиофайла. Реализация этого метода может потребовать, чтобы многократные синтаксические анализаторы исследовали поток, чтобы определить, поддерживают ли они это. Эти синтаксические анализаторы должны быть в состоянии отметить поток, считать достаточно многие данные, чтобы определить, поддерживают ли они поток, и, в противном случае сбрасывают указатель чтения потока на его исходную позицию. Если входной поток не поддерживает их работа, этот метод может перестать работать с IOException.

Параметры:

stream - входной поток тот, от который AudioInputStream должен быть создан

Возвраты:

AudioInputStream основанный на объектах на данных аудиофайла содержится во входном потоке.

Броски:

UnsupportedAudioFileException - если поток не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода-вывода происходит

См. Также:

InputStream.markSupported(), InputStream.mark(int)

getAudioInputStream

public static AudioInputStream getAudioInputStream(URL url)
                                            throws UnsupportedAudioFileException,
                                                   IOException

Получает поток аудиовхода из обеспеченного URL. URL должен указать на допустимые данные аудиофайла.

Параметры:

url - URL тот, для который AudioInputStream должен быть создан

Возвраты:

AudioInputStream основанный на объектах на данных аудиофайла указывается URL

Броски:

UnsupportedAudioFileException - если URL не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода-вывода происходит

getAudioInputStream

public static AudioInputStream getAudioInputStream(File file)
                                            throws UnsupportedAudioFileException,
                                                   IOException

Получает поток аудиовхода из обеспеченного File. File должен указать на допустимые данные аудиофайла.

Параметры:

file - File для которого AudioInputStream должен быть создан

Возвраты:

AudioInputStream основанный на объектах на данных аудиофайла, на которые указывают File

Броски:

UnsupportedAudioFileException - если File не указывает на допустимые данные аудиофайла, распознанные системой

IOException - если исключение ввода-вывода происходит

getAudioFileTypes

public static AudioFileFormat.Type[] getAudioFileTypes()

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

Возвраты:

массив уникальных типов файла. Если никакие типы файла не поддерживаются, массив длины 0 возвращается.

isFileTypeSupported

public static boolean isFileTypeSupported(AudioFileFormat.Type fileType)

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

Параметры:

fileType - тип файла, для которого запрашиваются возможности записи

Возвраты:

true если тип файла поддерживается, иначе false

getAudioFileTypes

public static AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)

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

Параметры:

stream - поток аудиовхода, для которого запрашивается поддержка типа аудиофайла

Возвраты:

массив типов файла. Если никакие типы файла не поддерживаются, массив длины 0 возвращается.

isFileTypeSupported

public static boolean isFileTypeSupported(AudioFileFormat.Type fileType,
                                          AudioInputStream stream)

Указывает, может ли аудиофайл указанного типа файла быть записан из обозначенного потока аудиовхода.

Параметры:

fileType - тип файла, для которого запрашиваются возможности записи

stream - поток, для которого запрашивается пишущая файл поддержка

Возвраты:

true если тип файла поддерживается для этого потока аудиовхода, иначе false

записать

public static int write(AudioInputStream stream,
                        AudioFileFormat.Type fileType,
                        OutputStream out)
                 throws IOException

Пишет поток байтов, представляющих аудиофайл указанного типа файла к обеспеченному потоку вывода. Некоторые типы файла требуют, чтобы длина была записана в заголовок файла; такие файлы не могут быть записаны от начала до конца, если длина не известна заранее. Попытка записать файл такого типа перестанет работать с IOException, если длина в типе аудиофайла будет AudioSystem.NOT_SPECIFIED.

Параметры:

stream - поток аудиовхода, содержащий аудиоданные, которые будут записаны файлу

fileType - вид аудиофайла, чтобы записать

out - поток, которому должны быть записаны данные файла

Возвраты:

число байтов, записанных потоку вывода

Броски:

IOException - если исключение ввода/вывода происходит

IllegalArgumentException - если тип файла не поддерживается системой

См. Также:

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type), getAudioFileTypes()

записать

public static int write(AudioInputStream stream,
                        AudioFileFormat.Type fileType,
                        File out)
                 throws IOException

Пишет поток байтов, представляющих аудиофайл указанного типа файла к внешнему обеспеченному файлу.

Параметры:

stream - поток аудиовхода, содержащий аудиоданные, которые будут записаны файлу

fileType - вид аудиофайла, чтобы записать

out - внешний файл, которому должны быть записаны данные файла

Возвраты:

число байтов, записанных файлу

Броски:

IOException - если исключение ввода-вывода происходит

IllegalArgumentException - если тип файла не поддерживается системой

См. Также:

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type), getAudioFileTypes()