dsp. AudioFileWriter

Поток к звуковому файлу

Описание

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

Записать аудиосэмплы в звуковой файл:

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

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

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? MATLAB.

Создание

Синтаксис

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 Используя Системные объекты (MATLAB).

Задайте имя звукового файла как вектор символов или скаляр строки.

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

  • 'AVI': чередование аудио и видео

  • 'WAV': Microsoft WAVE Files

  • '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)', чтобы сохранить несжатые аудиоданные в файл. Другие опции доступное отражение алгоритмы сжатия звука установлены в вашей системе. Можно использовать заполнение клавишей Tab, чтобы запросить допустимые опции Compressor для компьютера путем ввода H.Compressor = ' и затем нажатия клавиши TAB.

Зависимости

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

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

Зависимости

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

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

Для версий ранее, чем R2016b, используйте функцию step, чтобы запустить алгоритм Системного объекта. Аргументы к step являются объектом, который вы создали, сопровождаемый аргументами, показанными в этом разделе.

Например, y = step(obj,x) и y = obj(x) выполняют эквивалентные операции.

Синтаксис

afw(audio)

Описание

пример

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

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

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

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

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

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

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

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

release(obj)

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

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

Ограничения

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

Windows 7 macOS
  • Только частоты дискретизации 44 100 Гц и 48 000 Гц поддерживаются для формата файла MPEG-4 AAC. Для других форматов файлов нет никакого ограничения на частоту дискретизации.

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

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

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

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

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

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

Примеры

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

Примечание: Если вы используете 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);

Алгоритмы

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

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

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

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

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

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

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

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

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