audiowrite

Запишите звуковой файл

Синтаксис

audiowrite(filename,y,Fs)

audiowrite(filename,y,Fs,Name,Value)

Описание

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

пример

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

Примеры

свернуть все

Запись звукового файла

Попробовать в MATLAB

Создайте Файл 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);

Определение битов на выборку и метаданные

Попробовать в MATLAB

Создайте файл 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` Имя файла, чтобы записать
вектор символов | представляет скаляр в виде строки

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

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

Поддержка платформ	FileFormat
Все платформы	WAVE (`.wav`)
	OGG (`.ogg`)
	FLAC (`.flac`)
Windows^® и Mac	MPEG-4 AAC (`.m4a`, `.mp4`)

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

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

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

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

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

`y` Аудиоданные, чтобы записать
действительная матрица

Аудиоданные, чтобы записать, заданный как m-by-n действительная матрица, где m является количеством аудиосэмплов, чтобы записать и n, являются количеством звуковых каналов, чтобы записать.

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

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

FileFormat	Максимальное количество каналов
WAVE (`.wav`)	1024
OGG (`.ogg`)	255
FLAC (`.flac`)	8
MPEG-4 AAC (`.m4a`, `.mp4`)	2

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

Тип данных y	Допустимая Область значений для y
`uint8`	0 ≤ `y` ≤ 255
`int16`	- 32 768 ≤ `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. Значения Fs являются усеченными к целочисленным контурам. При записи в .m4a или файлы .mp4 на платформах Windows, audiowrite поддерживает только демонстрационные уровни 44 100 и 48000.

Пример: 44100

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

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (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'` — Quality для Компрессора Ogg Vorbis
75 (значений по умолчанию) | значение в области значений [0 100]

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

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

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

`заголовок` Информация о заголовке
`[]` (значение по умолчанию) | вектор символов | представляет скаляр в виде строки

Информация заголовка, указанная как пара, разделенная запятой, состоящая из '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	Выведите BitsPerSample	Тип выходных данных
WAVE (`.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 (`.ogg`)	`uint8`, `int16`, `int32`, `single`, `double`	Нет данных	`single`

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

audioinfo | audioread

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

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

Поддержка

Сообщество Экспонента

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

audiowrite

Синтаксис

Описание

Примеры

Запись звукового файла

Определение битов на выборку и метаданные

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

fileName Имя файла, чтобы записать вектор символов | представляет скаляр в виде строки

y Аудиоданные, чтобы записать действительная матрица

Fs — Частота дискретизации положительная скалярная величина

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

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

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

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

заголовок Информация о заголовке [] (значение по умолчанию) | вектор символов | представляет скаляр в виде строки

'Artist' — Информация о художнике [] (значение по умолчанию) | вектор символов | представляет скаляр в виде строки

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

Примечание

Алгоритмы

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

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

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

Поддержка

`fileName` Имя файла, чтобы записать
вектор символов | представляет скаляр в виде строки

`y` Аудиоданные, чтобы записать
действительная матрица

`Fs` — Частота дискретизации
положительная скалярная величина

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

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

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

`заголовок` Информация о заголовке
`[]` (значение по умолчанию) | вектор символов | представляет скаляр в виде строки

`'Artist'` — Информация о художнике
`[]` (значение по умолчанию) | вектор символов | представляет скаляр в виде строки

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