Класс AudioSystem

java.lang.Object

javax.sound.sampled.AudioSystem

public class AudioSystem extends Object

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

Свойства можно использовать для указания микшера по умолчанию для определённых типов линий. Учитываются как системные свойства, так и файл свойств. Файл свойств "sound.properties" считывается из расположения, зависящего от реализации (обычно это каталог conf в каталоге установки Java). Необязательное системное свойство "javax.sound.config.file" можно использовать для указания файла свойств, который будет прочитан в качестве начальной конфигурации. Если свойство задано и как системное свойство, и в файле свойств, приоритет имеет системное свойство. Если ничего не указано, среди доступных устройств выбирается подходящее значение по умолчанию. Синтаксис файла свойств описан в Properties.load. В следующей таблице перечислены доступные ключи свойств и методы, которые их учитывают:

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

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

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

Если указано имя микшера, выполняется поиск в полученном списке объектов Mixer.Info: будет возвращён первый объект с совпадающим именем, чей Mixer предоставляет соответствующий интерфейс линии. Если подходящий объект Mixer.Info не найден или имя микшера не указано, будет возвращён первый микшер из полученного списка, предоставляющий соответствующий интерфейс линии.

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

С версии:

1.3

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final 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(File file)`	Получает входной аудиопоток из предоставленного `File`.
`static AudioInputStream`	`getAudioInputStream(InputStream stream)`	Получает входной аудиопоток из предоставленного входного потока.
`static AudioInputStream`	`getAudioInputStream(URL url)`	Получает входной аудиопоток из предоставленного `URL`.
`static AudioInputStream`	`getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)`	Преобразуя предоставленный входной аудиопоток, получает входной аудиопоток с указанной кодировкой.
`static AudioInputStream`	`getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)`	Преобразуя предоставленный входной аудиопоток, получает входной аудиопоток указанного формата.
`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 sourceFormat)`	Получает кодировки, которые система может получить из входного аудиопотока указанного формата с помощью набора установленных преобразователей форматов.
`static AudioFormat.Encoding[]`	`getTargetEncodings(AudioFormat.Encoding sourceEncoding)`	Получает кодировки, которые система может получить из входного аудиопотока с указанной кодировкой с помощью набора установленных преобразователей форматов.
`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)`	Записывает в предоставленный выходной поток поток байтов, представляющий аудиофайл указанного типа.

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

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

Подробное описание полей

NOT_SPECIFIED

public static final int NOT_SPECIFIED

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

См. также:

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

getMixerInfo

public static Mixer.Info[] getMixerInfo()

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

Возвращает:

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

См. также:

getMixer

public static Mixer getMixer(Mixer.Info info)

Возвращает запрошенный аудиомикшер.

Параметры:

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

Возвращает:

запрошенный микшер

Исключения:

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

См. также:

getSourceLineInfo

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

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

Параметры:

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

Возвращает:

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

См. также:

getTargetLineInfo

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

Возвращает информацию обо всех линиях-приёмниках определённого типа, поддерживаемых установленными микшерами.

Параметры:

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

Возвращает:

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

См. также:

isLineSupported

public static boolean isLineSupported(Line.Info info)

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

Параметры:

info — объект Line.Info, описывающий линию, поддержку которой нужно проверить

Возвращает:

true, если поддерживается хотя бы одна соответствующая линия; в противном случае — false

См. также:

getLine

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

Возвращает линию, соответствующую описанию в указанном объекте Line.Info.

Если запрошена 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 — объект Line.Info, описывающий нужный тип линии
Возвращает:: линия запрошенного типа
Исключения:: LineUnavailableException — если соответствующая линия недоступна из-за ограничений ресурсов; IllegalArgumentException — если система не поддерживает ни одной линии, соответствующей указанному объекту Line.Info, ни через один из установленных микшеров

getClip

public static Clip getClip() throws LineUnavailableException

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

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

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

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

Возвращает:

нужный объект клипа

Исключения:

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

IllegalArgumentException — если система не поддерживает ни одного экземпляра клипа ни через один из установленных микшеров

С версии:

1.5

См. также:

getClip

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

С версии:

1.5

См. также:

getSourceDataLine

public static SourceDataLine getSourceDataLine(AudioFormat format) throws LineUnavailableException

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

Возвращённую линию следует открыть с помощью метода open(AudioFormat) или open(AudioFormat, int).

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

Формат аудио по умолчанию для возвращённого объекта SourceDataLine будет инициализирован значением format.

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

Параметры:

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

Возвращает:

нужный объект SourceDataLine

Исключения:

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

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

С версии:

1.5

См. также:

getSourceDataLine

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

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

Возвращённую линию следует открыть с помощью метода open(AudioFormat) или open(AudioFormat, int).

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

Формат аудио по умолчанию для возвращённого объекта SourceDataLine будет инициализирован значением format.

Параметры:

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

Возвращает:

нужный объект SourceDataLine

Исключения:

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

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

С версии:

1.5

См. также:

getTargetDataLine

public static TargetDataLine getTargetDataLine(AudioFormat format) throws LineUnavailableException

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

Возвращённую линию следует открыть с помощью метода open(AudioFormat) или open(AudioFormat, int).

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

Формат аудио по умолчанию для возвращённого объекта TargetDataLine будет инициализирован значением format.

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

Параметры:

Возвращает:

нужный объект TargetDataLine

Исключения:

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

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

С версии:

1.5

См. также:

getTargetDataLine

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

Возвращает линию данных-приёмник, которую можно использовать для записи аудиоданных в формате, заданном объектом AudioFormat, предоставляемую микшером, указанным объектом Mixer.Info.

Возвращённую линию следует открыть с помощью метода open(AudioFormat) или open(AudioFormat, int).

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

Формат аудио по умолчанию для возвращённого объекта TargetDataLine будет инициализирован значением format.

Параметры:

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

Возвращает:

нужный объект TargetDataLine

Исключения:

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

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

С версии:

1.5

См. также:

getTargetEncodings

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

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

Параметры:: sourceEncoding — кодировка, для которой проверяется поддержка преобразования
Возвращает:: массив кодировок. Если sourceEncoding не поддерживается, возвращается массив длины 0. В противном случае длина массива будет не менее 1; один из элементов представляет sourceEncoding (без преобразования).
Исключения:: NullPointerException — если sourceEncoding имеет значение null

getTargetEncodings

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

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

Параметры:: sourceFormat — аудиоформат, для которого проверяется возможность преобразования
Возвращает:: массив кодировок. Если sourceFormat не поддерживается, возвращается массив длины 0. В противном случае длина массива будет не менее 1; один из элементов представляет кодировку sourceFormat (без преобразования).
Исключения:: NullPointerException — если sourceFormat имеет значение null

isConversionSupported

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

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

Параметры:: targetEncoding — желаемая кодировка после преобразования; sourceFormat — аудиоформат до преобразования
Возвращает:: true, если преобразование поддерживается; в противном случае — false
Исключения:: NullPointerException — если targetEncoding или sourceFormat имеют значение null

getAudioInputStream

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

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

Параметры:

targetEncoding — желаемая кодировка после преобразования

sourceStream — поток для преобразования

Возвращает:

аудиопоток ввода с указанной кодировкой

Исключения:

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

NullPointerException — если targetEncoding или sourceStream имеют значение null

См. также:

getTargetFormats

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

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

Параметры:: targetEncoding — желаемая кодировка после преобразования; sourceFormat — аудиоформат до преобразования
Возвращает:: массив форматов. Если форматы с указанной кодировкой не поддерживаются, возвращается массив длины 0.
Исключения:: NullPointerException — если targetEncoding или sourceFormat имеют значение null

isConversionSupported

public static boolean isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)

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

Параметры:: targetFormat — желаемый аудиоформат после преобразования; sourceFormat — аудиоформат до преобразования
Возвращает:: true, если преобразование поддерживается; в противном случае — false
Исключения:: NullPointerException — если targetFormat или sourceFormat имеют значение null

getAudioInputStream

public static AudioInputStream getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)

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

Параметры:

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

sourceStream — поток для преобразования

Возвращает:

аудиопоток ввода указанного формата

Исключения:

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

NullPointerException — если targetFormat или sourceStream имеют значение null

См. также:

getAudioFileFormat

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

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

Параметры:

stream — входной поток, из которого следует извлечь сведения о формате файла

Возвращает:

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

Исключения:

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

IOException — если возникает исключение ввода-вывода

NullPointerException — если stream имеет значение null

См. также:

getAudioFileFormat

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

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

Параметры:: url — URL, из которого следует извлечь сведения о формате файла
Возвращает:: объект AudioFileFormat, описывающий формат аудиофайла
Исключения:: UnsupportedAudioFileException — если URL не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если url имеет значение null

getAudioFileFormat

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

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

Параметры:: file — File, из которого следует извлечь сведения о формате файла
Возвращает:: объект AudioFileFormat, описывающий формат аудиофайла
Исключения:: UnsupportedAudioFileException — если File не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если file имеет значение null

getAudioInputStream

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

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

Параметры:

stream — входной поток, на основе которого следует создать AudioInputStream

Возвращает:

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

Исключения:

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

IOException — если возникает исключение ввода-вывода

NullPointerException — если stream имеет значение null

См. также:

getAudioInputStream

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

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

Параметры:: url — URL, для которого следует создать AudioInputStream
Возвращает:: объект AudioInputStream, созданный на основе данных аудиофайла, на которые указывает URL
Исключения:: UnsupportedAudioFileException — если URL не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если url имеет значение null

getAudioInputStream

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

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

Параметры:: file — File, для которого следует создать AudioInputStream
Возвращает:: объект AudioInputStream, созданный на основе данных аудиофайла, на которые указывает File
Исключения:: UnsupportedAudioFileException — если File не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если file имеет значение null

getAudioFileTypes

public static AudioFileFormat.Type[] getAudioFileTypes()

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

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

isFileTypeSupported

public static boolean isFileTypeSupported(AudioFileFormat.Type fileType)

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

Параметры:: fileType — тип файла, для которого проверяется возможность записи
Возвращает:: true, если тип файла поддерживается, в противном случае false
Исключения:: NullPointerException — если fileType равно null

getAudioFileTypes

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

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

Параметры:: stream — поток аудиоввода, для которого проверяется поддержка типов аудиофайлов
Возвращает:: массив типов файлов. Если ни один тип файла не поддерживается, возвращается массив длины 0.
Исключения:: NullPointerException — если stream равно null

isFileTypeSupported

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

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

Параметры:: fileType — тип файла, для которого проверяется возможность записи; stream — поток, для которого проверяется поддержка записи файлов
Возвращает:: true, если тип файла поддерживается для этого потока аудиоввода, в противном случае false
Исключения:: NullPointerException — если fileType или stream равны null

write

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

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

Параметры:

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

fileType — тип аудиофайла для записи

out — поток, в который следует записать данные файла

Возвращает:

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

Исключения:

IOException — если возникает исключение ввода-вывода

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

NullPointerException — если stream или fileType или out равны null

См. также:

write

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

Записывает во внешний файл последовательность байтов, представляющую аудиофайл указанного типа.

Параметры:

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

fileType — тип аудиофайла для записи

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

Возвращает:

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

Исключения:

IOException — если возникает исключение ввода-вывода

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

NullPointerException — если stream или fileType или out равны null

См. также:

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/AudioSystem.html