audiowrite

Запись аудиофайла

Синтаксис

audiowrite (имя файла, y, Fs)

audiowrite (имя файла, y, Fs, имя, значение)

Описание

audiowrite(filename,y,Fs) записывает матрицу аудиоданных, y, с частотой выборки Fs в файл с именем filename. filename input также определяет формат выходного файла. Тип выходных данных зависит от формата выходного файла и типа данных аудиоданных, y.

пример

audiowrite(filename,y,Fs,Name,Value) использует дополнительные параметры, указанные одним или несколькими Name,Value аргументы пары.

Примеры

свернуть все

Запись аудиофайла

Открыть сценарий

Создание файла WAVE из файла примера handel.matи прочитайте файл обратно в MATLAB ®.

Записать WAVE (.wav) файл в текущей папке.

load handel.mat

filename = 'handel.wav';
audiowrite(filename,y,Fs);
clear y Fs

Считывание данных в MATLAB с помощью audioread.

[y,Fs] = audioread(filename);

Слушайте звук.

sound(y,Fs);

Укажите биты на образец и метаданные

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

Создание файла FLAC из файла примера handel.mat и указать количество выходных битов на выборку и комментарий.

load handel.mat

filename = 'handel.flac';
audiowrite(filename,y,Fs,'BitsPerSample',24,...
'Comment','This is my new audio file.');
clear y Fs

Просмотр информации о новом файле FLAC с помощью audioinfo функция

info = audioinfo(filename) ;

info структура содержит следующие информационные поля: Filename, CompressionMethod, NumChannels, SampleRate, TotalSamples, Duration, Title, Comment, Artist, и BitsPerSample.

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

свернуть все

`filename` - Имя файла для записи
вектор символов | строковый скаляр

Имя файла для записи или полный путь к файлу, указанный как вектор символов или скаляр строки, включающий расширение файла.

В зависимости от места, в которое вы пишете, filename может принять одну из этих форм.

Местоположение

Форма

Текущая папка

Для записи в текущую папку укажите имя файла в filename.

Пример:'sample_audio.wav'

Другие папки

Чтобы записать в папку, отличную от текущей, укажите полный или относительный путь в filename.

Пример: 'C:\myFolder\sample_audio.mp3'

Пример: 'myFolder\sample_audio.wav'

Удаленное расположение

Для записи в удаленное расположение filename должен содержать полный путь к файлу, указанному как унифицированный указатель ресурса (URL) формы:

scheme_name://path_to_file/my_file.ext

В зависимости от вашего удаленного местоположения, scheme_name может быть одним из значений в этой таблице.

Удаленное расположение	`scheme_name`
Амазонский S3™	`s3`
Хранилище больших двоичных объектов Windows Azure ®	`wasb`, `wasbs`
HDFS™	`hdfs`

Дополнительные сведения см. в разделе Работа с удаленными данными.

Пример: 's3://bucketname/path_to_file/sample_audio.mp3'

audiowrite поддерживает следующие форматы файлов.

Поддержка платформы	Формат файла
Все платформы	ВОЛНА (`.wav`)
	ОГГ (`.ogg`)
	FLAC (ПОЗ.`.flac`)
Windows ® и Mac	MPEG-4 КРК (`.m4a`, `.mp4`)

Пример: 'myFile.m4a'

Пример: '../myFile.m4a'

Пример: 'C:\temp\myFile.m4a'

При записи файлов AAC в Windows audiowrite накладывает на переднюю и заднюю стороны выходного сигнала дополнительные образцы тишины. Кодировщик AAC Windows также размещает очень резкое замирание и замирание звука. Это приводит к увеличению количества отсчетов после записи на диск.

Типы данных: char | string

`y` - Аудиоданные для записи
реальная матрица

Записываемые аудиоданные, указанные как mоколо-n вещественная матрица, где m - количество аудиоотсчетов для записи и n - количество записываемых аудиоканалов.

Если либо m или n равно 1, то audiowrite предполагает, что это измерение определяет количество аудиоканалов, а другое измерение определяет количество аудиоотсчетов.

Максимальное количество каналов зависит от формата файла.

Формат файла	Максимальное количество каналов
ВОЛНА (`.wav`)	1024
ОГГ (`.ogg`)	255
FLAC (ПОЗ.`.flac`)	8
MPEG-4 КРК (`.m4a`, `.mp4`)	2

Допустимый диапазон для данных в y зависит от типа данных y.

Тип данных y	Допустимый диапазон для y
`uint8`	0 ≤ `y` ≤ 255
`int16`	-32768 ≤ `y` ≤ +32767
`int32`	-2^31 ≤ `y` ≤ 2^31–1
`single`	-1.0 ≤ `y` ≤ +1.0
`double`	-1.0 ≤ `y` ≤ +1.0

Данные за пределами допустимого диапазона отсекаются.

Если y является single или double, затем аудиоданные в y нормализовать до значений в диапазоне − 1,0 и 1,0 включительно .

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

`Fs` - Частота выборки
положительный целочисленный скаляр

Частота дискретизации аудиоданных в герцах y, указано как положительное целое значение скаляра больше 0. При записи в .m4a или .mp4 файлы на платформах Windows, audiowrite поддерживает только скорости выборки 44100 и 48000.

Пример: 44100

Типы данных: double

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'Title','Symphony No. 9','Artist','My Orchestra' инструктирует audiowrite написать аудиофайл с названием «Симфония № 9» и информацией артиста «Мой оркестр».

`'BitsPerSample'` - Количество выходных битов на выборку
16 (по умолчанию) | 8 | 24 | 32 | 64

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

Доступно только для WAVE (.wav) и FLAC (.flac) файлы. Для FLAC-файлов поддерживается только 8, 16 или 24 бита на выборку.

Пример: 'BitsPerSample',32

`'BitRate'` - Килобит в секунду (кбит/с)
128 (по умолчанию) | 64 | 96 | 160 | 192 | 256 | 320

Количество килобит в секунду (кбит/с), используемых для сжатых аудиофайлов, указанное как пара, разделенная запятыми, состоящая из 'BitRate' и целое число. В Windows 7 или более поздних версиях допустимыми являются только 96, 128, 160 и 192.

В общем, больше BitRate значение приводит к повышению качества сжатия.

Доступно только для MPEG-4 (.m4a, .mp4) файлы.

Пример: 'BitRate',96

`'Quality'` - Настройка качества компрессора Ogg Vorbis
75 (по умолчанию) | значение в диапазоне [0 100]

Настройка качества компрессора Ogg Vorbis, указанная как пара, разделенная запятыми, состоящая из 'Quality' и число в диапазоне [0 100], где 0 - более низкое качество и более высокое сжатие, а 100 - более высокое качество и более низкое сжатие.

Доступно только для OGG (.ogg) файлы.

Пример: 'Quality',25

`'Title'` - Титульная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр

Информация заголовка, указанная как разделенная запятыми пара, состоящая из 'Title' и вектор символов или строковый скаляр.

Типы данных: char | string

`'Artist'` - Информация об исполнителе
`[]` (по умолчанию) | символьный вектор | строковый скаляр

Информация об исполнителе, указанная как разделенная запятыми пара, состоящая из 'Artist' и вектор символов или строковый скаляр.

Типы данных: char | string

`'Comment'` - Дополнительная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр

Дополнительная информация, указанная как разделенная запятыми пара, состоящая из 'Comment' и вектор символов или строковый скаляр.

Типы данных: char | string

Примечание

На платформах Mac audiowrite записывает метаданные только в файлы WAVE, OGG и FLAC и не записывает 'Title', 'Author', или 'Comment' для MPEG-4 файлов AAC.

Алгоритмы

Тип выходных данных определяется форматом файла, типом данных yи указанные выходные данные BitsPerSample.

Форматы файлов	Тип данных y	Выходные данные PerSample	Тип выходных данных
ВОЛНА (`.wav`),	`uint8`, `int16`, `int32`, `single`, `double`	8	`uint8`
		16	`int16`
		24	`int32`
	`uint8`, `int16`, `int32`	32	`int32`
	`single`, `double`	32	`single`
	`single`, `double`	64	`double`
FLAC (ПОЗ.`.flac`)	`uint8`, `int16`, `int32`, `single`, `double`	8	`int8`
		16	`int16`
		24	`int32`
MPEG-4 (`.m4a`, `.mp4`), ОГГ (`.ogg`)	`uint8`, `int16`, `int32`, `single`, `double`	Н/Д	`single`

См. также

audioinfo | audioread

Темы

Чтение и запись аудиофайлов

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

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

audiowrite

Синтаксис

Описание

Примеры

Запись аудиофайла

Укажите биты на образец и метаданные

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

`filename` - Имя файла для записи
вектор символов | строковый скаляр

`y` - Аудиоданные для записи
реальная матрица

`Fs` - Частота выборки
положительный целочисленный скаляр

Аргументы пары «имя-значение»

`'BitsPerSample'` - Количество выходных битов на выборку
16 (по умолчанию) | 8 | 24 | 32 | 64

`'BitRate'` - Килобит в секунду (кбит/с)
128 (по умолчанию) | 64 | 96 | 160 | 192 | 256 | 320

`'Quality'` - Настройка качества компрессора Ogg Vorbis
75 (по умолчанию) | значение в диапазоне [0 100]

`'Title'` - Титульная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр

`'Artist'` - Информация об исполнителе
`[]` (по умолчанию) | символьный вектор | строковый скаляр

`'Comment'` - Дополнительная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр

Алгоритмы

См. также

Темы

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

Поддержка

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

audiowrite

Синтаксис

Описание

Примеры

Запись аудиофайла

Укажите биты на образец и метаданные

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

filename - Имя файла для записи вектор символов | строковый скаляр

y - Аудиоданные для записи реальная матрица

Fs - Частота выборки положительный целочисленный скаляр

Аргументы пары «имя-значение»

'BitsPerSample' - Количество выходных битов на выборку 16 (по умолчанию) | 8 | 24 | 32 | 64

'BitRate' - Килобит в секунду (кбит/с) 128 (по умолчанию) | 64 | 96 | 160 | 192 | 256 | 320

'Quality' - Настройка качества компрессора Ogg Vorbis 75 (по умолчанию) | значение в диапазоне [0 100]

'Title' - Титульная информация [] (по умолчанию) | символьный вектор | строковый скаляр

'Artist' - Информация об исполнителе [] (по умолчанию) | символьный вектор | строковый скаляр

'Comment' - Дополнительная информация [] (по умолчанию) | символьный вектор | строковый скаляр

Алгоритмы

См. также

Темы

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

Поддержка

`filename` - Имя файла для записи
вектор символов | строковый скаляр

`y` - Аудиоданные для записи
реальная матрица

`Fs` - Частота выборки
положительный целочисленный скаляр

`'BitsPerSample'` - Количество выходных битов на выборку
16 (по умолчанию) | 8 | 24 | 32 | 64

`'BitRate'` - Килобит в секунду (кбит/с)
128 (по умолчанию) | 64 | 96 | 160 | 192 | 256 | 320

`'Quality'` - Настройка качества компрессора Ogg Vorbis
75 (по умолчанию) | значение в диапазоне [0 100]

`'Title'` - Титульная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр

`'Artist'` - Информация об исполнителе
`[]` (по умолчанию) | символьный вектор | строковый скаляр

`'Comment'` - Дополнительная информация
`[]` (по умолчанию) | символьный вектор | строковый скаляр