audioplayer

Объект для игры аудио

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

Описание

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

Создание

Синтаксис

player = audioplayer(Y,Fs)
player = audioplayer(Y,Fs,nBits)
player = audioplayer(Y,Fs,nBits,ID)
player = audioplayer(recorder)
player = audioplayer(recorder,ID)

Описание

пример

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 объект с использованием объекта audio recorder 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 функция.

Объект Audio Recorder, заданный как 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Остановите воспроизведение или запись

Примеры

свернуть все

Открыть Live Script

Загрузка и воспроизведение выборки аудио файла.

Загрузка 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);
Открыть Live Script

Запись аудио данных с микрофона и воспроизведение записанного аудио.

Создайте 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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте