Класс 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

См. также:

write

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

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

NullPointerException - если stream или fileType или out являются 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/AudioFileWriter.html