dsp.AudioFileWriter

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

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

Описание

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

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

  1. Создайте dsp.AudioFileWriter Объекту и установите его свойства.

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

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

Создание

Синтаксис

afw = dsp.AudioFileWriter
afw = dsp.AudioFileWriter(File name)
afw = dsp.AudioFileWriter(Name,Value)

Описание

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® Аудио

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

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

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

Значение по умолчанию является 'WAV'.

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

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

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

Зависимости

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

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

Зависимости

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

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

Синтаксис

afw(audio)

Описание

пример

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

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

расширить все

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

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

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

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

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

release(obj)

расширить все

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

Примеры

свернуть все

Открыть Live Script

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

Децимируйте аудиосигнал и запишите его на диск как файл.

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

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

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

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

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

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

  • Не все частоты дискретизации поддерживаются, хотя Mac Audio Toolbox API явным образом не задает ограничение.

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

Алгоритмы

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

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

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

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

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

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

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

.

См. также

Объекты

Темы

Введенный в R2012a

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

Поддержка

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