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.

Примеры

свернуть все

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

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

свернуть все

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

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-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
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. Значения 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' и номера.

Только доступный для 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), uint8, int16, int32, single, double8uint8
16int16
24int32
uint8, int16, int3232int32
single, double32single
single, double64double
FLAC (.flac)uint8, int16, int32, single, double8int8
16int16
24int32
MPEG-4 (.m4a, .mp4),
OGG (.ogg)
uint8, int16, int32, single, doubleНет данныхsingle

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

|

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

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