javax.sound.sampled

Интерфейс DataLine

Все Суперинтерфейсы:

AutoCloseable, Строка

Все Известные Подынтерфейсы:

Клип, SourceDataLine, TargetDataLine

public interface DataLine
extends Line

DataLine добавляет связанная с носителями функциональность к ее суперинтерфейсу, Line. Эта функциональность включает методы транспортного контрля, которые запускают, останавливают, истощают, и сбрасывают аудиоданные, которые проходят через строку. Строка данных может также сообщить о текущей позиции, объеме, и аудиоформате носителей. Строки данных используются для вывода аудио посредством подынтерфейсов SourceDataLine или Clip, которые позволяют прикладной программе писать данные. Точно так же аудиовход обрабатывается подынтерфейсом TargetDataLine, который позволяет данным быть считанными.

У строки данных есть внутренний буфер, в котором ставятся в очередь поступление или исходящие аудиоданные. drain() блоки метода, пока этот внутренний буфер не становится пустым, обычно потому что все данные с очередями были обработаны. flush() метод отбрасывает любые доступные данные с очередями от внутреннего буфера.

Строка данных производит START и STOP события всякий раз, когда это начинает или прекращает активное представление или получение данных. Эти события могут быть сгенерированы в ответ на определенные запросы, или в результате менее прямых изменений состояния. Например, если start() вызывается на неактивной строке данных, и данные доступны для получения или воспроизведения, a START событие будет сгенерировано коротко, когда воспроизведение данных или получение фактически начнутся. Или, если поток данных к активной строке данных сжимается так, чтобы разрыв произошел в представлении данных, a STOP событие сгенерировано.

Микшеры часто поддерживают синхронизируемое управление многократных строк данных. Синхронизация может быть установлена через интерфейс Микшера synchronize метод. См. описание Mixer интерфейс для более полного описания.

С тех пор:

1.3

См. Также:

LineEvent

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Интерфейс и Описание
static class	DataLine. Информация Помимо информации о class, наследованной от ее суперкласса, DataLine.Info обеспечивает дополнительную информацию, определенную для строк данных.

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

Модификатор и Тип	Метод и Описание
int	available() Получает число байтов данных, в настоящий момент доступных приложению для того, чтобы обработать во внутреннем буфере строки данных.
void	drain() Поставленные в очередь данные утечек от строки, продолжая ввод-вывод данных, пока внутренний буфер строки данных не был освобожден.
void	flush() Сбросы поставленные в очередь данные от строки.
int	getBufferSize() Получает максимальное количество байтов данных, которые поместятся во внутренний буфер строки данных.
AudioFormat	getFormat() Получает текущий формат (кодирование, демонстрационный уровень, число каналов, и т.д.) аудиоданных строки данных.
int	getFramePosition() Получает текущую позицию в аудиоданных, в демонстрационных фреймах.
float	getLevel() Получает текущий уровень громкости для строки.
long	getLongFramePosition() Получает текущую позицию в аудиоданных, в демонстрационных фреймах.
long	getMicrosecondPosition() Получает текущую позицию в аудиоданных, в микросекундах.
boolean	isActive() Указывает, участвует ли строка в активном вводе-выводе (таком как воспроизведение или получение).
boolean	isRunning() Указывает, работает ли строка.
void	start() Позволяет строке участвовать во вводе-выводе данных.
void	stop() Останавливает строку.

Методы, наследованные от интерфейса javax.sound.sampled. Строка

addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener

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

истощить

void drain()

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

См. Также:

flush()

сброс

void flush()

Сбросы поставленные в очередь данные от строки. Сброшенные данные отбрасываются. В некоторых случаях не все данные с очередями могут быть отброшены. Например, микшер может сбросить данные от буфера для определенной входной строки, но любые неиграемые данные уже в буфере вывода (результат соединения) будут все еще играться. Можно вызвать этот метод после приостановки строки (нормальный случай), если Вы хотите пропустить "устарелые" данные, когда Вы перезапускаете воспроизведение или получение. (Законно сбросить строку, которая не останавливается, но выполнение так на активной строке, вероятно, вызовет разрыв в данных, приводящих к заметному щелчку.)

См. Также:

stop(), drain()

запустить

void start()

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

См. Также:

stop(), isRunning(), LineEvent

остановиться

void stop()

Останавливает строку. Остановленная строка должна прекратить действие ввода-вывода. Если строка открыта и выполнение, однако, это должно сохранить ресурсы, требуемые возобновлять действие. Остановленная строка должна сохранить любые аудиоданные в своем буфере вместо того, чтобы отбросить это, так, чтобы после возобновления ввод-вывод мог продолжаться, где это кончило, если возможный. (Это не гарантирует, что никогда не будет разрывов вне текущего буфера, конечно; если остановленное условие продолжается слишком долго, выборки ввода или вывода могли бы быть отброшены.) При желании сохраненные данные могут быть отброшены, вызывая flush метод. Когда аудио получение или остановки воспроизведения, a STOP событие сгенерировано.

См. Также:

start(), isRunning(), flush(), LineEvent

isRunning

boolean isRunning()

Указывает, работает ли строка. Значение по умолчанию false. Открытая строка начинает работать, когда первые данные представляются в ответ на вызов start метод, и продолжается, пока представление не прекращается в ответ на звонок stop или потому что воспроизведение завершается.

Возвраты:

true если строка работает, иначе false

См. Также:

start(), stop()

isActive

boolean isActive()

Указывает, участвует ли строка в активном вводе-выводе (таком как воспроизведение или получение). Когда неактивная строка становится активной, она отправляет a START событие его слушателям. Точно так же, когда активная строка становится неактивной, она отправляет a STOP событие.

Возвраты:

true если строка активно получает или представляет звук, иначе false

См. Также:

Line.isOpen(), Line.addLineListener(javax.sound.sampled.LineListener), Line.removeLineListener(javax.sound.sampled.LineListener), LineEvent, LineListener

getFormat

AudioFormat getFormat()

Получает текущий формат (кодирование, демонстрационный уровень, число каналов, и т.д.) аудиоданных строки данных.

Если строка не открыта и никогда не открывалась, она возвращает формат значения по умолчанию. Формат значения по умолчанию является реализацией определенный аудиоформат, или, если DataLine.Info объект, который использовался, чтобы получить это DataLine, определяет по крайней мере один полностью определенный аудиоформат, последний будет использоваться в качестве формата значения по умолчанию. Открытие строки с определенным аудиоформатом (например. SourceDataLine.open(AudioFormat)) переопределит формат значения по умолчанию.

Возвраты:

текущий формат аудиоданных

См. Также:

AudioFormat

getBufferSize

int getBufferSize()

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

Возвраты:

размер буфера в байтах

доступный

int available()

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

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

Приложению гарантируют это операцию чтения или операцию записи до числа байтов, возвращенных из available() не будет блокировать; однако, нет никакой гарантии, которая пытается считать или записать, что больше данных блокирует.

Возвраты:

доступный объем данных, в байтах

getFramePosition

int getFramePosition()

Получает текущую позицию в аудиоданных, в демонстрационных фреймах. Позиция фрейма измеряет число демонстрационных фреймов, полученных, или представленный от, строка, так как это было открыто. Это возвращаемое значение повторится после 2^31 фреймы. Рекомендуется использовать getLongFramePosition вместо этого.

Возвраты:

число кадров, уже обработанных начиная со строки, было открыто

См. Также:

getLongFramePosition()

getLongFramePosition

long getLongFramePosition()

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

Возвраты:

число кадров, уже обработанных начиная со строки, было открыто

С тех пор:

1.5

getMicrosecondPosition

long getMicrosecondPosition()

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

Возвраты:

число микросекунд данных, обработанных начиная со строки, было открыто

getLevel

float getLevel()

Получает текущий уровень громкости для строки. Этот уровень является мерой амплитуды тока сигнала, и не должен быть перепутан с текущей установкой управления усилением. Диапазон от 0.0 (тишина) к 1.0 (максимальная возможная амплитуда для звуковой формы волны). Модули измеряют линейную амплитуду, не децибелы.

Возвраты:

амплитуда тока сигнала в этой строке, или AudioSystem.NOT_SPECIFIED