audioplayer

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

Синтаксис

проигрыватель = audioplayer (Y, Фс) проигрыватель = audioplayer (Y, Фс, nBits) проигрыватель = audioplayer (Y, Фс, nBits, ID) проигрыватель = audioplayer (устройство записи) проигрыватель = audioplayer (устройство записи, ID)

Описание

player = audioplayer(Y,Fs) создает объект audioplayer для Y сигнала, с помощью частоты дискретизации Fs. Функция возвращает указатель на объект audioplayer, 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, который использует идентифицированный byID аудио устройства для вывода.

Входные параметры

Y

Звуковой сигнал, представленный векторным или двумерным массивом, содержащим single, double, int8, uint8 или значения int16.

Диапазон значений входной выборки зависит от типа данных. В следующей таблице перечислены эти области значений.

Тип данных	Демонстрационный диапазон значений
`int8`	- От 128 до 127
`uint8`	От 0 до 255
`int16`	- От 32768 до 32 767
`единственный`	- От 1 до 1
`'double'`	- От 1 до 1

Fs

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

nBits

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

Значение по умолчанию: 16

ID

Идентификатор устройства. Чтобы получить ID устройства, используйте функцию audiodevinfo.

Значение по умолчанию: -1 (устройство по умолчанию)

recorder

Объект магнитофона создается audiorecorder.

Методы

Примечание

При вызове любого метода включайте имя объекта audioplayer с помощью синтаксиса функций, такого как stop(player).

`получение`	Запросите свойства объекта `audioplayer`.
`isplaying`	Запросите, происходит ли воспроизведение: возвращает `true` или `false`.
`приостановка`	Приостановите воспроизведение.
`игра`	Проигрывайте аудио с начала до конца.
`playblocking`	Вопроизведите и не возвращайте управление, пока воспроизведение не завершится.
`resume`	Перезапустите воспроизведение от приостановленного положения.
`набор`	Установите свойства объекта `audioplayer`.
`остановка`	Остановите воспроизведение.

Смотрите страницы с описанием для get, play, playblocking и set для дополнительных опций синтаксиса.

Свойства

`'BitsPerSample'`	Количество битов на выборку. Только для чтения
`CurrentSample`	Текущая выборка, которую проигрывает устройство аудиовыхода. Если устройство не вопроизводит, `CurrentSample` является следующей выборкой, которая вопроизведет с `play` или `resume`. Только для чтения
`DeviceID`	Идентификатор для аудио устройства. Только для чтения
`NumberOfChannels`	Количество звуковых каналов. Только для чтения
`Running`	Состояние аудиоплеера: `'on'` или `'off'`. Только для чтения
`SampleRate`	Частота дискретизации в Гц.
`TotalSamples`	Общая длина аудиоданных в выборках. Только для чтения
`Тег`	Метка объекта.
`Ввод`	Имя класса: `audioplayer` Только для чтения
`UserData`	Любой тип дополнительных данных, чтобы сохранить объектом.

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

`StartFcn`	Функция, чтобы выполнить одно время, когда воспроизведение запускается.
`StopFcn`	Функция, чтобы выполнить одно время, когда воспроизведение останавливается.
`TimerFcn`	Функция, чтобы выполняться неоднократно во время воспроизведения. Чтобы задать временные интервалы для повторений, используйте свойство `TimerPeriod`.
`TimerPeriod`	Время в секундах между обратными вызовами `TimerFcn`. Значение по умолчанию: `.05`

Примеры

Загрузите и проигрывайте демонстрационный звуковой файл “Хора Аллилуйи Генделя”:

load handel;
player = audioplayer(y, Fs);
play(player);

Смотрите также

audiodevinfo | магнитофон | звук

Темы

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

Была ли эта тема полезной?

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