Класс AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter extends Object

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

С момента:: 1.3

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

AudioFileWriter()

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

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

Модификатор и тип	Метод	Описание
`abstract AudioFileFormat.Type[]`	`getAudioFileTypes()`	Получает типы файлов, для которых данная запись аудиофайла предоставляет поддержку записи.
`abstract AudioFileFormat.Type[]`	`getAudioFileTypes(AudioInputStream stream)`	Получает типы файлов, которые данный записыватель аудиофайлов может записать из указанного потока аудиовхода.
`boolean`	`isFileTypeSupported(AudioFileFormat.Type fileType)`	Указывает, предоставляется ли поддержка записи файла для указанного типа файла этим записывателем аудиофайлов.
`boolean`	`isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)`	Указывает, можно ли записать аудиофайл указанного типа из указанного потока аудиовхода.
`abstract int`	`write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)`	Записывает поток байтов, представляющий аудиофайл указанного формата в указанный внешний файл.
`abstract int`	`write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out)`	Записывает поток байтов, представляющий аудиофайл указанного типа в предоставленный выходной поток.

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

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

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

AudioFileWriter

protected AudioFileWriter()

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

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

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

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

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

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

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

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

getAudioFileTypes

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

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

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

isFileTypeSupported

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

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

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

write

public abstract 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

См. также:

isFileTypeSupported(Type, AudioInputStream)
getAudioFileTypes()

write

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

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

NullPointerException - если stream или fileType или out являются null

См. также:

isFileTypeSupported(Type, AudioInputStream)
getAudioFileTypes()

© 1993, 2021, 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/17/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileWriter.html