dsp.AudioFileWriter

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

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

Описание

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

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

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

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

Создание

Синтаксис

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

`Filename` — Имя звукового файла, в который можно записать
`'output.wav'` (значение по умолчанию) | вектор символов | строковый скаляр

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

`FileFormat` — Формат аудиофайла
`'WAV'` (значение по умолчанию) | `'AVI'` | `'FLAC'` | `'OGG'` | `'MPEG4'` | `'WMA'`

Задайте, какой формат аудиофайла объект пишет. На платформах 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'.

`SampleRate` — Частота дискретизации потока аудиоданных
44100 (значение по умолчанию) | положительная скалярная величина

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

`Compressor` — Алгоритм, который сжимает аудиоданные
`'None (uncompressed)'` (значение по умолчанию) | `'CCITT A-Law'` | `'CCITT u-Law'` | `'GSM 6.10'` | `'IMA ADPCM'` | `'Microsoft ADPCM'` | `'PCM'`

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

Зависимости

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

`DataType` — Тип данных несжатого аудио
`'int16'` (значение по умолчанию) | `'double'` | `'single'` | `'inherit'` | `'int24'` | `'int32'` | `'uint8'`

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

Зависимости

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

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

Синтаксис

afw(audio)

Описание

пример

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

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

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

`audio` — Аудиосэмплы
вектор-столбец | матрица

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

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

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

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

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

release(obj)

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

Характерный для всех системных объектов

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

Примеры

свернуть все

Запишите звуковой сигнал в файл WAV

Скрипт Open Live Script

Примечание: Если вы используете 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
Только частоты дискретизации 44 100 Гц и 48 000 Гц поддерживаются для формата файла MPEG-4 AAC. Для других форматов файлов нет никакого ограничения на частоту дискретизации.	Только моно или выходные параметры стерео позволены для формата файла MPEG-4 AAC. Для всех других форматов позволены больше чем два канала аудиовыхода.
Только моно или выходные параметры стерео позволены для формата файла MPEG-4 AAC. Для всех других форматов позволены больше чем два канала аудиовыхода.
Выходные данные дополнены на обоих передняя и задняя часть сигнала с дополнительными выборками тишины. Энкодер Windows AAC помещает резкое постепенное появление и постепенное исчезновение на звуковых сигналах, вызывая сигналы быть немного более длинным в выборках, когда записано в диск.	Не все частоты дискретизации поддерживаются, несмотря на то, что API Audio Toolbox Mac явным образом не задает ограничение.
Минимум 1 025 выборок на канал должен быть записан в файл MPEG-4 AAC.

Алгоритмы

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

Объект FileFormat свойство не поддерживает форматы файлов только для видео.
Объект не имеет никакого соответствующего свойства для параметра Write. Объект пишет только звуковое содержимое в файлы.
Объект не имеет никакого соответствующего свойства для параметра Video compressor.
Объект не имеет никакого соответствующего свойства для параметра File color format.
Объект не имеет никакого соответствующего свойства для параметра Image signal.

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

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Смотрите системные объекты в Генерации кода MATLAB (MATLAB Coder).
Исполняемый файл, сгенерированный от этого Системного объекта, использует предварительно созданные динамические файлы библиотеки (.dll файлы) включенный с MATLAB^®. Используйте packNGo функционируйте, чтобы группировать код, сгенерированный от этого объекта и всех соответствующих файлов в сжатом zip-файле. Используя этот zip-файл, можно переместить, распаковать и восстановить проект в другой среде разработки, где MATLAB не установлен. Для получения дополнительной информации смотрите, Как Запустить Сгенерированный Исполняемый файл Вне MATLAB.

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

Объекты

dsp.AudioFileReader

Темы

Как запустить сгенерированный исполняемый файл вне MATLAB

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

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

dsp.AudioFileWriter

Описание

Создание

Синтаксис

Описание

Свойства

`Filename` — Имя звукового файла, в который можно записать
`'output.wav'` (значение по умолчанию) | вектор символов | строковый скаляр

`FileFormat` — Формат аудиофайла
`'WAV'` (значение по умолчанию) | `'AVI'` | `'FLAC'` | `'OGG'` | `'MPEG4'` | `'WMA'`

`SampleRate` — Частота дискретизации потока аудиоданных
44100 (значение по умолчанию) | положительная скалярная величина

`Compressor` — Алгоритм, который сжимает аудиоданные
`'None (uncompressed)'` (значение по умолчанию) | `'CCITT A-Law'` | `'CCITT u-Law'` | `'GSM 6.10'` | `'IMA ADPCM'` | `'Microsoft ADPCM'` | `'PCM'`

Зависимости

`DataType` — Тип данных несжатого аудио
`'int16'` (значение по умолчанию) | `'double'` | `'single'` | `'inherit'` | `'int24'` | `'int32'` | `'uint8'`

Зависимости

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

Синтаксис

Описание

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

`audio` — Аудиосэмплы
вектор-столбец | матрица

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

Характерный для всех системных объектов

Примеры

Запишите звуковой сигнал в файл WAV

Ограничения

Алгоритмы

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

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

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

Объекты

Темы

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

Поддержка

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

dsp.AudioFileWriter

Описание

Создание

Синтаксис

Описание

Свойства

Filename — Имя звукового файла, в который можно записать 'output.wav' (значение по умолчанию) | вектор символов | строковый скаляр

FileFormat — Формат аудиофайла 'WAV' (значение по умолчанию) | 'AVI' | 'FLAC' | 'OGG' | 'MPEG4' | 'WMA'

SampleRate — Частота дискретизации потока аудиоданных44100 (значение по умолчанию) | положительная скалярная величина

Compressor — Алгоритм, который сжимает аудиоданные 'None (uncompressed)' (значение по умолчанию) | 'CCITT A-Law' | 'CCITT u-Law' | 'GSM 6.10' | 'IMA ADPCM' | 'Microsoft ADPCM' | 'PCM'

Зависимости

DataType — Тип данных несжатого аудио 'int16' (значение по умолчанию) | 'double' | 'single' | 'inherit' | 'int24' | 'int32' | 'uint8'

Зависимости

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

Синтаксис

Описание

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

audio — Аудиосэмплы вектор-столбец | матрица

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

Характерный для всех системных объектов

Примеры

Запишите звуковой сигнал в файл WAV

Ограничения

Алгоритмы

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

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

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

Объекты

Темы

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

Поддержка

`Filename` — Имя звукового файла, в который можно записать
`'output.wav'` (значение по умолчанию) | вектор символов | строковый скаляр

`FileFormat` — Формат аудиофайла
`'WAV'` (значение по умолчанию) | `'AVI'` | `'FLAC'` | `'OGG'` | `'MPEG4'` | `'WMA'`

`SampleRate` — Частота дискретизации потока аудиоданных
44100 (значение по умолчанию) | положительная скалярная величина

`Compressor` — Алгоритм, который сжимает аудиоданные
`'None (uncompressed)'` (значение по умолчанию) | `'CCITT A-Law'` | `'CCITT u-Law'` | `'GSM 6.10'` | `'IMA ADPCM'` | `'Microsoft ADPCM'` | `'PCM'`

`DataType` — Тип данных несжатого аудио
`'int16'` (значение по умолчанию) | `'double'` | `'single'` | `'inherit'` | `'int24'` | `'int32'` | `'uint8'`

`audio` — Аудиосэмплы
вектор-столбец | матрица

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.