exponenta event banner

audiorecorder

Объект для записи звука

Описание

Использовать audiorecorder объект для записи аудиоданных из устройства ввода, такого как микрофон, для обработки в MATLAB ®. audiorecorder содержит свойства, обеспечивающие дополнительную гибкость при записи. Например, можно приостановить, возобновить или определить обратные вызовы с помощью audiorecorder функции объекта.

Создание

Описание

пример

recorder = audiorecorder создает и возвращает audiorecorder объект со следующими свойствами:

  • Частота дискретизации Fs = 8000 герц

  • Биты на выборку nBits = 8

  • Количество каналов nChannels = 1

пример

recorder = audiorecorder(Fs,nBits,NumChannels) устанавливает частоту выборки Fs (в герцах), разряды на выборку nBitsи количество каналов nChannels.

пример

recorder = audiorecorder(Fs,nBits,NumChannels,ID) устанавливает устройство ввода звука на устройство, указанное ID.

Входные аргументы

развернуть все

Частота дискретизации в герцах (Гц), заданная как числовой скаляр.

Допустимые значения частоты дискретизации зависят как от частоты дискретизации, разрешенной MATLAB, так и от конкретного звукового оборудования в системе. MATLAB имеет жесткое ограничение 1000 Гц < =Fs < = 384000 Гц, хотя применяются дополнительные аппаратно-зависимые ограничения. Типичными значениями, поддерживаемыми большинством звуковых карт, являются 8000, 11025, 22050, 44100, 48000 и 96000 герц.

Типы данных: single | double

Биты на выборку, указано как 8, 16, или 24.

Определить nBits только когда сигнал Y содержит значения с плавающей запятой. Допустимые значения nBits зависит от звукового оборудования. Например, в зависимости от звукового оборудования, nBits может быть одним из следующих значений: 8, 16, или 24.

Количество каналов, указанное как 1 (моно) или 2 (стерео).

Идентификатор устройства, указанный как целое число.

Для получения идентификатора устройства используйте audiodevinfo функция.

Свойства

развернуть все

Это свойство доступно только для чтения.

Биты на выборку, возвращаемые как положительное целое число.

Это свойство доступно только для чтения.

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

Если устройство не записывается, CurrentSample является следующим образцом для записи с помощью record или resume методы.

Это свойство доступно только для чтения.

Идентификатор звукового устройства, возвращаемый как целое число.

Это свойство доступно только для чтения.

Состояние аудиомагнитофона, возвращено как on или off.

Частота дискретизации в герцах (Гц), возвращаемая как числовой скаляр.

Для установки SampleRate, используйте Fs входной аргумент при построении audiorecorder объект.

Это свойство доступно только для чтения.

Общая длина аудиоданных в выборках, возвращаемых в виде целого числа.

Метка, заданная как символьный вектор.

Это свойство доступно только для чтения.

Имя класса объекта, возвращенное как 'audiorecorder'.

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

Функция для выполнения в начале записи, заданная как вектор символов или строковый скаляр, содержащий имя функции, или дескриптор функции.

Первые два входа в функцию обратного вызова должны быть audiorecorder объект и event структура. Дополнительные сведения см. в разделе Функции обратного вызова.

Функция для выполнения в конце записи, заданная как вектор символов или строковый скаляр, содержащий имя функции, или дескриптор функции.

Первые два входа в функцию обратного вызова должны быть audiorecorder объект и event структура. Дополнительные сведения см. в разделе Функции обратного вызова.

Функция для многократного выполнения во время записи, заданная как вектор символов или строковый скаляр, содержащий имя функции, или дескриптор функции. Чтобы задать временные интервалы для повторов, используйте TimerPeriod собственность.

Первые два входа в функцию обратного вызова должны быть audiorecorder объект и event структура. Дополнительные сведения см. в разделе Функции обратного вызова.

Период таймера, указанный как числовой скаляр.

Период таймера - это время в секундах между TimerFcn обратные вызовы.

Функции объекта

getЗапрос значений свойств для audiorecorder объект
getaudiodataСохранить записанный аудиосигнал в цифровом массиве
getplayerСоздает связанные audioplayer объект
isrecordingОпределить, выполняется ли запись
pauseПриостановка воспроизведения или записи
playВоспроизведение звука из audiorecorder объект
recordЗапись звука в audiorecorder объект
recordblockingЗапись звука в audiorecorder объект, удерживать управление до завершения записи
resume Возобновить воспроизведение или запись из приостановленного состояния
setЗадать значения свойств для audiorecorder объект
stopОстановить воспроизведение или запись

Примеры

свернуть все

Запишите аудиоданные из микрофона, а затем воспроизведите записанный звук.

Создание audiorecorder со значениями свойств по умолчанию.

recObj = audiorecorder;

Либо создайте audiorecorder с требуемыми свойствами. Для аудио CD-качества в стерео определите следующие свойства: частота дискретизации (Fs), количество бит на выборку (nBits), количество каналов (nChannels) и идентификатор устройства ввода (ID).

Fs = 44100 ; 
nBits = 16 ; 
nChannels = 2 ; 
ID = -1; % default audio input device 
recObj = audiorecorder(Fs,nBits,nChannels,ID);

Соберите пятисекундный образец речи с помощью микрофона.

disp('Start speaking.')
Start speaking.
recordblocking(recObj,5);
disp('End of Recording.');
End of Recording.

Воспроизвести запись.

play(recObj);
Представлен до R2006a