Класс AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader extends Object

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

Since:: 1.3

Краткое описание конструкторов

AudioFileReader()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract AudioFileFormat`	`getAudioFileFormat(File file)`	Получает формат аудиофайла `File`.
`abstract AudioFileFormat`	`getAudioFileFormat(InputStream stream)`	Получает формат аудиофайла предоставленного потока ввода.
`abstract AudioFileFormat`	`getAudioFileFormat(URL url)`	Получает формат аудиофайла предоставленного `URL`.
`abstract AudioInputStream`	`getAudioInputStream(File file)`	Получает поток аудиоввода из предоставленного `File`.
`abstract AudioInputStream`	`getAudioInputStream(InputStream stream)`	Получает поток аудиоввода из предоставленного потока ввода.
`abstract AudioInputStream`	`getAudioInputStream(URL url)`	Получает поток аудиоввода из предоставленного `URL`.

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

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

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

AudioFileReader

protected AudioFileReader()

Конструктор для вызова подклассами.

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

getAudioFileFormat

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

IOException - если произошла ошибка ввода-вывода

NullPointerException - если stream имеет null

См. также:

getAudioFileFormat

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

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

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

getAudioFileFormat

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

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

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

getAudioInputStream

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

IOException - если произошла ошибка ввода-вывода

NullPointerException - если stream имеет null

См. также:

getAudioInputStream

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

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

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

getAudioInputStream

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

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileReader.html