javax.sound.sampled

Класс AudioInputStream

java.lang. Объект

java.io. InputStream

javax.sound.sampled. AudioInputStream

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

public class AudioInputStream
extends InputStream

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

AudioSystem class включает много методов, которые управляют AudioInputStream объекты. Например, методы, которым позволяют Вы:

• получите поток аудиовхода из внешнего аудиофайла, поток, или URL
• запишите внешний файл из потока аудиовхода
• преобразуйте поток аудиовхода в различный аудиоформат

С тех пор:

1.3

См. Также:

AudioSystem, Clip.open(AudioInputStream)

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

Поля

Модификатор и Тип	Поле и Описание
protected AudioFormat	формат Формат аудиоданных содержится в потоке.
protected long	frameLength Длина этого потока, в демонстрационных фреймах.
protected long	framePos Текущая позиция в этом потоке, в демонстрационных (основанных на нуле) фреймах.
protected int	frameSize Размер каждого фрейма, в байтах.

Сводка конструктора

Конструкторы

Конструктор и Описание
AudioInputStream(InputStream stream, AudioFormat format, long length) Создает поток аудиовхода, у которого есть требуемый формат и длина в демонстрационных фреймах, используя аудиоданные от указанного входного потока.
AudioInputStream(TargetDataLine line) Создает поток аудиовхода, который читает его данные из целевой обозначенной строки данных.

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

Модификатор и Тип	Метод и Описание
int	available() Возвращает максимальное количество байтов, которые могут быть считаны (или перескочиться) от этого потока аудиовхода без блокирования.
void	close() Завершения этот поток аудиовхода и выпуски любые системные ресурсы связались с потоком.
AudioFormat	getFormat() Получает аудиоформат звуковых данных в этом потоке аудиовхода.
long	getFrameLength() Получает длину потока, выраженного в демонстрационных фреймах, а не байтах.
void	mark(int readlimit) Отмечает текущую позицию в этом потоке аудиовхода.
boolean	markSupported() Тесты, поддерживает ли этот поток аудиовхода mark и reset методы.
int	read() Читает следующий байт данных от потока аудиовхода.
int	read(byte[] b) Чтения некоторое число байтов от потока аудиовхода и хранят их в буферный массив b.
int	read(byte[] b, int off, int len) Чтения до указанного максимального количества байтов данных от аудиопотока, помещая их в данный байтовый массив.
void	reset() Репозиции этот поток аудиовхода к позиции это имело в это время mark метод был последний вызванный.
long	skip(long n) Перескакивает и отбрасывает конкретное количество байтов от этого потока аудиовхода.

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

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

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

формат

protected AudioFormat format

Формат аудиоданных содержится в потоке.

frameLength

protected long frameLength

Длина этого потока, в демонстрационных фреймах.

frameSize

protected int frameSize

Размер каждого фрейма, в байтах.

framePos

protected long framePos

Текущая позиция в этом потоке, в демонстрационных (основанных на нуле) фреймах.

Деталь конструктора

AudioInputStream

public AudioInputStream(InputStream stream,
                        AudioFormat format,
                        long length)

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

Параметры:

stream - поток тот, на который это AudioInputStream объект базируется

format - формат аудиоданных этого потока

length - длина в демонстрационных фреймах данных в этом потоке

AudioInputStream

public AudioInputStream(TargetDataLine line)

Создает поток аудиовхода, который читает его данные из целевой обозначенной строки данных. Формат потока является тем же самым как той из целевой строки данных, и длина AudioSystem#NOT_SPECIFIED.

Параметры:

line - целевая строка данных, из которой этот поток получает свои данные.

См. Также:

AudioSystem.NOT_SPECIFIED

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

getFormat

public AudioFormat getFormat()

Получает аудиоформат звуковых данных в этом потоке аудиовхода.

Возвраты:

объект аудиоформата описание формата этого потока

getFrameLength

public long getFrameLength()

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

Возвраты:

длина в демонстрационных фреймах

читать

public int read()
         throws IOException

Читает следующий байт данных от потока аудиовхода. Потоковый тип телосложения аудиовхода должен составить один байт, или IOException будет брошен.

Определенный:

read в class InputStream

Возвраты:

следующий байт данных, или-1, если конец потока достигается

Броски:

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

См. Также:

read(byte[], int, int), read(byte[]),

читать

public int read(byte[] b)
         throws IOException

Чтения некоторое число байтов от потока аудиовхода и хранят их в буферный массив b. Число байтов фактически чтение возвращается как целое число. Этот метод блоки до входных данных доступен, конец потока обнаруживается, или исключение выдается.

Этот метод будет всегда читать целое число фреймов. Если длина массива не является целым числом фреймов, максимумом b.length - (b.length % frameSize) байты будут считаны.

Переопределения:

read в class InputStream

Параметры:

b - буфер, в который читаются данные

Возвраты:

общее количество чтения байтов в буфер, или-1, если нет больше данных, потому что конец потока был достигнут

Броски:

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

См. Также:

read(byte[], int, int), read(), available()

читать

public int read(byte[] b,
                int off,
                int len)
         throws IOException

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

Этот метод будет всегда читать целое число фреймов. Если len не определяет целое число фреймов, максимум len - (len % frameSize) байты будут считаны.

Переопределения:

read в class InputStream

Параметры:

b - буфер, в который читаются данные

off - смещение, с начала массива b, в котором будут записаны данные

len - максимальное количество байтов, чтобы читать

Возвраты:

общее количество чтения байтов в буфер, или-1, если нет больше данных, потому что конец потока был достигнут

Броски:

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

См. Также:

read(byte[]), read(), skip(long), available()

пропустить

public long skip(long n)
          throws IOException

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

Переопределения:

skip в class InputStream

Параметры:

n - требуемое число байтов, которые будут пропущены

Возвраты:

фактическое число байтов пропускается

Броски:

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

См. Также:

read(), available()

доступный

public int available()
              throws IOException

Возвращает максимальное количество байтов, которые могут быть считаны (или перескочиться) от этого потока аудиовхода без блокирования. Этот предел применяется только к следующему вызову a read или skip метод для этого потока аудиовхода; предел может измениться каждый раз, когда эти методы вызываются. В зависимости от базового потока может быть брошен IOException, если этот поток закрывается.

Переопределения:

available в class InputStream

Возвраты:

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

Броски:

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

См. Также:

read(byte[], int, int), read(byte[]), read(), skip(long)

близко

public void close()
           throws IOException

Завершения этот поток аудиовхода и выпуски любые системные ресурсы связались с потоком.

Определенный:

close в интерфейсе Closeable

Определенный:

close в интерфейсе AutoCloseable

Переопределения:

close в class InputStream

Броски:

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

метка

public void mark(int readlimit)

Отмечает текущую позицию в этом потоке аудиовхода.

Переопределения:

mark в class InputStream

Параметры:

readlimit - максимальное количество байтов, которые могут быть считаны перед позицией метки, становится недопустимым.

См. Также:

reset(), markSupported()

сброс

public void reset()
           throws IOException

Репозиции этот поток аудиовхода к позиции это имело в это время mark метод был последний вызванный.

Переопределения:

reset в class InputStream

Броски:

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

См. Также:

mark(int), markSupported()

markSupported

public boolean markSupported()

Тесты, поддерживает ли этот поток аудиовхода mark и reset методы.

Переопределения:

markSupported в class InputStream

Возвраты:

true если этот поток поддерживает mark и reset методы; false иначе

См. Также:

mark(int), reset()