audioplayer

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

Описание

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

Создание

Описание

пример

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 до 32 767

single

- От 1 до 1

double

- От 1 до 1

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

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

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

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

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

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

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

Чтобы получить ID устройства, используйте 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
Для просмотра документации необходимо авторизоваться на сайте