Exponenta Banner
exponenta event banner

dsp. AudioFileWriter

Потоковая передача в аудиофайл

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

Описание

dsp.AudioFileWriter Система object™ записывает образцы звука в аудиофайл.

Чтобы записать образцы звука в аудиофайл:

  1. Создать dsp.AudioFileWriter и задайте его свойства.

  2. Вызовите объект с аргументами, как если бы это была функция.

Дополнительные сведения о работе системных объектов см. в разделе Что такое системные объекты?.

Создание

Синтаксис

afw = dsp. AudioFileWriter
afw = dsp. AudioFileWriter (имя файла)
afw = dsp. AudioFileWriter (имя, значение)

Описание

afw = dsp.AudioFileWriter возвращает системный объект записи аудиофайлов, afw. Этот объект записывает образцы звука в аудиофайл.

afw = dsp.AudioFileWriter(File name) возвращает системный объект записи аудиофайлов, afw. Этот объект имеет Filename свойство имеет значение File name.

пример

afw = dsp.AudioFileWriter(Name,Value) возвращает объект записи аудиофайлов с заданным значением каждого свойства. Заключите каждое имя свойства в отдельные кавычки. Неопределенные свойства имеют значения по умолчанию.

Свойства

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

Если не указано иное, свойства не настраиваются, что означает невозможность изменения их значений после вызова объекта. Объекты блокируются при их вызове, и release функция разблокирует их.

Если свойство настраивается, его значение можно изменить в любое время.

Дополнительные сведения об изменении значений свойств см. в разделе Проектирование системы в MATLAB с использованием системных объектов.

Укажите имя аудиофайла в виде символьного вектора или строкового скаляра.

Укажите, какой формат аудиофайла записывает объект. На платформах Microsoft ® выберите одну из 'AVI', 'WAV', 'FLAC', 'OGG', 'MPEG4', 'WMA'. На платформах Linux ® выберите одну из 'AVI', 'WAV', 'FLAC', или 'OGG'. На платформах macOS выберите одну из 'AVI', 'WAV', 'FLAC', 'OGG', или 'MPEG4'. Эти сокращения соответствуют следующим форматам файлов:

  • 'AVI': Аудио-видеоперемежение

  • 'WAV': Файлы Microsoft WAVE

  • 'WMA': Windows Media ® Audio

  • 'FLAC': Бесплатный аудиокодек без потерь

  • 'OGG': Ogg/Vorbis Сжатый аудиофайл

  • 'MPEG4': MPEG-4 Файл AAC - можно использовать оба .m4a и .mp4 расширения

Значение по умолчанию: 'WAV'.

Укажите частоту дискретизации входных аудиоданных как положительное числовое скалярное значение.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Укажите тип алгоритма сжатия, используемого устройством записи аудиофайлов для сжатия аудиоданных. Сжатие уменьшает размер аудиофайла. Выбрать 'None (uncompressed)' для сохранения несжатых аудиоданных в файл. Другие доступные опции отражают алгоритмы сжатия звука, установленные в системе. Для запроса допустимости можно использовать заполнение вкладки Compressor параметры компьютера путем ввода H.Compressor = ' а затем нажмите клавишу TAB.

Зависимости

Это свойство применяется при записи файлов WAV или AVI на платформах Windows ®.

Укажите тип несжатых аудиоданных, записанных в файл как 'int16', 'double', 'single', 'inherit', 'int24', 'int32', или 'uint8'.

Зависимости

Это свойство применяется только при записи несжатых WAV-файлов.

Использование

Синтаксис

afw (аудио)

Описание

пример

afw(audio) записывает один кадр аудиоотсчетов, audio, в выходной файл, указанный Filename. audio является либо вектором для ввода монозвукового сигнала, либо матрицей M-на-N для ввода аудиосигнала N-канала соответственно.

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

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

Один кадр аудиоотсчетов, возвращаемый в виде вектора столбца или матрицы. Ввод вектора столбца указывает на ввод монозвукового сигнала. Матрица M-на-N указывает N-канальный звуковой вход.

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

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

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

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

release(obj)

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

stepЗапустить алгоритм объекта System
releaseДеблокирование ресурсов и разрешение изменений значений свойств объекта системы и входных признаков
resetСброс внутренних состояний объекта System

Примеры

свернуть все

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

Примечание.При использовании R2016a или более ранней версии замените каждый вызов объекта эквивалентным step синтаксис. Например, obj() становится step(obj).

Прорежьте звуковой сигнал и запишите его на диск в виде WAV-файла.

afr = dsp.AudioFileReader('OutputDataType',...
   'double');
firdec = dsp.FIRDecimator; % decimate by 2
afw = dsp.AudioFileWriter...
   ('speech_dft.wav', ...
   'SampleRate', afr.SampleRate/2);

while ~isDone(afr)
     audio = afr();
     audiod = firdec(audio);
     afw(audiod);
end

release(afr);
release(afw);

Ограничения

При записи этих файлов применяются следующие специфичные для платформы ограничения:

Windows 7 macOS

  • Для формата файла 44100 AAC поддерживаются только частоты дискретизации 48000 Гц и MPEG-4 Гц. Для других форматов файлов ограничения на частоту выборки отсутствуют.

  • Только моно или продукция стерео допускается формат файла MPEG-4 AAC. Для всех остальных форматов допускается более двух каналов вывода звука.

  • Только моно или продукция стерео позволена для формата файла MPEG-4 AAC. Для всех остальных форматов допускается более двух каналов вывода звука.

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

    Кодер AAC Windows размещает резкие замирания и замирания на звуковых сигналах, что приводит к тому, что сигналы немного длиннее в выборках при записи на диск.

  • Поддерживаются не все частоты дискретизации, хотя API-интерфейс Mac Audio Toolbox явно не указывает ограничение.

  • В файл 1025 AAC должно быть записано не менее MPEG-4 выборок на канал.

Алгоритмы

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

  • Объект FileFormat не поддерживает форматы файлов только для видео.

  • Объект не имеет соответствующего свойства для параметра Write. Объект записывает в файлы только аудиоконтент.

  • Объект не имеет соответствующего свойства для параметра Video compressor.

  • Объект не имеет соответствующего свойства для параметра Формат цвета файла.

  • Объект не имеет соответствующего свойства для параметра сигнала Image.

Расширенные возможности

.

См. также

Объекты

Темы

Представлен в R2012a

Документация по системной панели инструментов DSP

Поддержка