audiowrite

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

Описание

пример

audiowrite(filename,y,Fs) пишет матрица аудиоданных, y, с частотой дискретизации Fs к файлу под названием filename. filename введите также задает формат выходного файла. Тип выходных данных зависит от формата выходного файла и типа данных аудиоданных, 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длительностьзаголовок, Comment, Artist, и BitsPerSample.

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

свернуть все

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

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

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

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

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

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

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

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

Аудиоданные, чтобы записать в виде m- 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
uint80 ≤ 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

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

Пример: 44100

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

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

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

Пример: 'Title','Symphony No. 9','Artist','My Orchestra' сообщает audiowrite записать звуковой файл с заголовком “Симфония № 9” и информация о художнике “Мой Оркестр”.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Алгоритмы

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

Форматы файловТип данных yВыведите BitsPerSampleТип выходных данных
WAVE (.wav), uint8int16int32единственный'double'8uint8
16int16
24int32
uint8int16int3232int32
single'double'32single
single'double'64double
FLAC (.flac)uint8int16int32единственный'double'8int8
16int16
24int32
MPEG-4 (.m4a, .mp4),
OGG (.ogg)
uint8int16int32единственный'double'Нет данныхsingle

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

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