dsp.AudioRecorder

Аудиоданные записи с помощью аудио устройства компьютера

Совместимость

Примечание

dsp.AudioRecorder объект будет удален в будущем релизе. Существующие экземпляры объекта продолжают запускаться. Для нового кода используйте audioDeviceReader объект от Audio Toolbox™ вместо этого.

Описание

AudioRecorder аудиоданные записей объекта с помощью аудио устройства компьютера.

Записывать аудиоданные с помощью аудио устройства компьютера:

  1. Задайте и настройте свой объект магнитофона. Смотрите Конструкцию.

  2. Вызовите step записывать аудиоданные согласно свойствам dsp.AudioRecorder. Поведение step характерно для каждого объекта в тулбоксе.

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

Примечание

Запуск в R2016b, вместо того, чтобы использовать step метод, чтобы выполнить операцию, заданную Системным объектом, можно вызвать объект с аргументами, как будто это была функция. Например, y = step(obj,x) и y = obj(x) выполните эквивалентные операции.

Конструкция

H = dsp.AudioRecorder возвращает объект магнитофона, H, это записывает аудиосэмплы с помощью устройства аудиовхода в режиме реального времени.

H = dsp.AudioRecorder('PropertyName',PropertyValue, ...) возвращает объект магнитофона, H, с каждым набором свойств к заданному значению.

Свойства

DeviceName

Устройство, от которого можно получить аудиоданные

Задайте устройство, от которого можно получить аудиоданные. Значением по умолчанию является Default, который является стандартным устройством ввода данных компьютера. Можно использовать заполнение клавишей Tab, чтобы запросить допустимый DeviceName присвоения для вашего компьютера путем ввода H.DeviceName = ' и затем нажатие клавиши TAB. Функциональность заполнения клавишей Tab показывает все допустимые имена аудио устройства для вашего компьютера.

SampleRate

Количество выборок в секунду считано из аудио устройства

Задайте количество выборок в секунду в сигнале как целое число. Значение по умолчанию 44100. Это свойство является настраиваемым.

NumChannels

Количество звуковых каналов

Задайте количество звуковых каналов как целое число. Значение по умолчанию равняется 2.

DeviceDataType

Тип данных используется устройством

Задайте тип данных, используемый устройством, чтобы получить аудиоданные как Determine from output data type , 8-bit integer, 16-bit integer, 24-bit integer, или 32-bit float. Значением по умолчанию является Determine from output data type.

BufferSizeSource

Источник Buffer Size

Задайте, как определить buffer size как Auto или Property. Значением по умолчанию является Auto.

BufferSize

Buffer size

Задайте как целое число размер буфера, который магнитофон возражает использованию, чтобы передать с аудио устройством. Это свойство применяется, когда вы устанавливаете BufferSizeSource свойство к Property. Значением по умолчанию является 4096. Это свойство является настраиваемым. Настройка этого свойства включает баланс между задержкой устройства и возможностью понижающихся данных (недостаточное наполнение буфера). Момент вы получаете буфер от устройства, у вас есть выборки, которые являются относительно новыми и выборки, которые, по крайней мере, так же стары как размер буфера. Поэтому buffer size вводит latency, который является временем, требуемым для устройства заполнять очередь и буфер. BufferSize половина размера буфера звуковой карты. Размер буфера, обработанного в каждом прерывании от аудио устройства, влияет на производительность системы. Система координат данных не может пройти через очередь, пока буфер не заполнен устройством, таким образом вводя задержку. BufferSize должно быть меньшим, чем эффективная длительность очереди. Установить BufferSize к значению кроме значения по умолчанию сначала измените BufferSizeSource к 'Свойству'. Можно выбрать BufferSize из списка свойств.

QueueDuration

Размер очереди в секундах

Задайте длину аудио-очереди в секундах. Значением по умолчанию является 1.0. Это свойство является настраиваемым. Цель очереди состоит в том, чтобы управлять компромиссом между уволенным данных и задержкой. Задержка вычисляется следующим уравнением: latency=QueueDuration×SampleRate+2×BufferSizeSampleRate.

Чтобы минимизировать задержку, понизьте QueueDuration или набор это к 0. Однако имейте в виду, что уволенные данных или потеря системной робастности могут закончиться. QueueDuration свойство задает длительность сигнала в секундах, которые могут быть буферизованы во время симуляции. Это значение является максимальным отрезком времени, что предоставление данных Системного объекта может изолировать требование данных устройства. Если уровень пропускной способности MATLAB® ниже, чем уровень пропускной способности устройства, переполнение буфера происходит. Можно использовать OutputNumOverrunSamples контролировать превышенный. Чтобы откорректировать переполнение, сделайте длительность очереди больше, чем буфер. Если уровень пропускной способности MATLAB выше, чем уровень пропускной способности устройства, недостаточное наполнение буфера происходит, заставляя Системный объект ожидать новых выборок, чтобы стать доступным. Чтобы свести к минимуму вероятность уволенных, проверки Системного объекта, чтобы проверить длительность очереди являются, по крайней мере, столь же большими как максимум buffer size и формата кадра. Если это не, длительность очереди автоматически установлена в это максимальное значение. В начале симуляции очередь переполнена тишиной. На каждом временном шаге аудио устройство отправляет буфер выборок к верхней части очереди.

SamplesPerFrame

Количество выборок в выходном сигнале

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

OutputDataType

Тип данных выхода

Выберите тип выходных данных как uint8int16int32 единственный , или double. Значением по умолчанию является double.

OutputNumOverrunSamples

Включите выход превышенного количества

Установите на true выводить количество выборок, пропущенных из-за очереди, превышенной начиная с последней возможности к step метод. Значением по умолчанию является false.

ChannelMappingSource

Источник отображения канала устройства

Задайте, определить ли канал, сопоставляющий как 'Auto' или как 'Property'. Если вы устанавливаете значение ChannelMappingSource к 'Auto', ChannelMapping поле представляется неактивное. Если вы устанавливаете это свойство на 'Property', вектор, заданный в поле ChannelMapping, используется, чтобы направить вход. Кроме того, NumChannels поле представляется неактивное, потому что карта канала содержит информацию о количестве каналов данных, которые пользователь пытается считать.

ChannelMapping

Отображение канала устройства к данным

Вектор допустимых индексов канала, чтобы представлять отображение между входом устройства образовывает канал и данные. Термин Channel Mapping относится к 1 к 1 отображению, которое сопоставляет каналы на выбранном аудио устройстве к каналам данных. Когда вы записываете аудио, отображение канала позволяет вам задавать, какой канал аудиоданных направляет вход к определенному каналу аудио. По умолчанию, ChannelMapping поле [1:MAXNUMINPUTCHANNELS], где MAXNUMINPUTCHANNELS зависит от выбранного устройства.

Методы

шагЗапишите аудио от регистрирующего устройства
Характерный для всех системных объектов
release

Позвольте изменения значения свойства Системного объекта

Поиск и устранение проблем

Выполнение исполняемого файла вне MATLAB

Чтобы запустить ваше сгенерированное приложение независимого исполняемого файла в Shell, необходимо установить среду на следующее:

ПлатформаКоманда
Mac

setenv DYLD_LIBRARY_PATH $LD_LIBRARY_PATH: $MATLABROOT/bin/maci64 (csh/tcsh)

export DYLD_LIBRARY_PATH $LD_LIBRARY_PATH: $MATLABROOT/bin/maci64 (Bash)

Linux

setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH: $MATLABROOT/bin/glnxa64 (csh/tcsh)

export LD_LIBRARY_PATH $LD_LIBRARY_PATH: $MATLABROOT/bin/glnxa64 (Bash)

Windows

set PATH = $MATLABROOT\bin\win64;%PATH%

Алгоритмы

Этот объект реализует алгоритм, входные параметры и выходные параметры, описанные на странице с описанием блока From Audio Device. Свойства объектов соответствуют параметрам блоков.

Представленный в R2012a