Exponenta Banner
exponenta event banner

audioplayer

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

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

Описание

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

Создание

Синтаксис

player = аудиоплейер (Y, F)
player = аудиоплейер (Y, Fs, nBits)
player = аудиоплейер (Y, F, nBits, ID)
player = аудиоплеер (регистратор)
player = аудиоплеер (регистратор, идентификатор)

Описание

пример

player = audioplayer(Y,Fs) создает audioplayer объект для сигнала Y, с использованием частоты выборки Fs. Функция возвращает объект аудиоплеера, player.

пример

player = audioplayer(Y,Fs,nBits) использование nBits биты на выборку для сигнала Y.

пример

player = audioplayer(Y,Fs,nBits,ID) использует звуковое устройство, идентифицированное ID для вывода.

пример

player = audioplayer(recorder) создает audioplayer объект с использованием объекта аудиомагнитофона recorder.

пример

player = audioplayer(recorder,ID) создает объект из recorder который использует звуковое устройство, идентифицированное ID для вывода.

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

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

Звуковой сигнал, определяемый как вектор или двумерный массив числовых данных.

Диапазон значений входного образца зависит от типа данных.

Тип данных

Диапазон значений выборки

int8

от -128 до 127

uint8

от 0 до 255

int16

от -32768 до 32767

single

от -1 до 1

double

от -1 до 1

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

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

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

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

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

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

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

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

Объект аудиомагнитофона, указанный как audiorecorder объект. Используйте audiorecorder для создания объекта.

Свойства

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

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

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

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

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

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

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

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

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

Количество аудиоканалов, возвращенных как 1 или 2.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

getЗапрос значений свойств для audioplayer объект
isplayingОпределить, выполняется ли воспроизведение
pauseПриостановка воспроизведения или записи
playВоспроизведение звука из audioplayer объект
playblockingВоспроизведение звука из audioplayer объект, держать управление до завершения воспроизведения
resume Возобновить воспроизведение или запись из приостановленного состояния
setЗадать значения свойств для audioplayer объект
stopОстановить воспроизведение или запись

Примеры

свернуть все

Открыть сценарий в реальном времени

Загрузите и воспроизведите образец аудиофайла.

Груз handel.mat в рабочую область. Файл содержит образец массива аудиоданных y и частота выборки Fs. 

load('handel.mat')
whos y Fs
  Name          Size             Bytes  Class     Attributes

  Fs            1x1                  8  double              
  y         73113x1             584904  double

Создание audioplayer объект для воспроизведения файла.

player = audioplayer(y,Fs);

Воспроизведение аудиообъекта на аудиоустройстве по умолчанию. 

play(player);
Открыть сценарий в реальном времени

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

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

recObj = audiorecorder;

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

disp('Start speaking.')
Start speaking.

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

Создайте объект аудиоплеера из записи, а затем воспроизведите записанный образец.

playerObj = audioplayer(recObj);
play(playerObj);

Ограничения

  • Эти ограничения применяются при использовании audioplayer в MATLAB Online™:

    • Невозможно создать audioplayer объект из recorder объект.

    • Нельзя изменить частоту выборки существующего audioplayer объект.

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

Подробнее

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

Совет

  • Воспроизведение звука в MATLAB Online поддерживается в Google Chrome™.

См. также

| |

Темы

Представлен до R2006a

Документация MATLAB

Поддержка