javax.sound.sampled

Класс AudioInputStream

java.lang. Объект

java.io. InputStream

javax.sound.sampled. AudioInputStream

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

Closeable, AutoCloseable

public class AudioInputStream
extends InputStream

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

AudioSystem класс включает много методов, которые управляют 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) Перескакивает и отбрасывает конкретное количество байтов от этого потока звукового входа.

Методы 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 в классе InputStream

Возвраты:

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

Броски:

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

См. Также:

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

читать

public int read(byte[] b)
         throws IOException

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

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

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

read в классе 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 в классе InputStream

Параметры:

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

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

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

Возвраты:

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

Броски:

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

См. Также:

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

пропустить

public long skip(long n)
          throws IOException

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

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

skip в классе InputStream

Параметры:

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

Возвраты:

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

Броски:

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

См. Также:

read(), available()

доступный

public int available()
              throws IOException

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

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

available в классе InputStream

Возвраты:

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

Броски:

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

См. Также:

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

близко

public void close()
           throws IOException

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

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

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

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

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

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

close в классе InputStream

Броски:

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

метка

public void mark(int readlimit)

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

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

mark в классе InputStream

Параметры:

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

См. Также:

reset(), markSupported()

сброс

public void reset()
           throws IOException

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

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

reset в классе InputStream

Броски:

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

См. Также:

mark(int), markSupported()

markSupported

public boolean markSupported()

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

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

markSupported в классе InputStream

Возвраты:

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

См. Также:

mark(int), reset()