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.

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

свернуть все

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

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

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

Форма

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

Чтобы записать в текущую папку, задайте имя файла в filename.

Example:'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
Amazon S3™s3
Windows Azure® Устройство хранения данных блобаwasb, wasbs
HDFS™hdfs

Для получения дополнительной информации смотрите работу с Удаленными данными.

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

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 имя аргумента и 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'N/Asingle

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

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