Exponenta Banner

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);
Скрипт Open Live Script

Создайте файл 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)256
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
единственный- 1,0 ≤ y ≤ +1.0
'double'- 1,0 ≤ y ≤ +1.0

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

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

Типы данных: единственный | удваиваются | int16 | int32 | uint8

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

Пример: 44100

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

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

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

Пример: 'Заголовок', 'Симфония № 9', 'Художник', 'Мой Оркестр' дает 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) файлы.

Пример: 'Скорость передачи', 96

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

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

Пример: 'Качество', 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, double32единственный
single, double64'double'
FLAC (.flac)uint8, int16, int32, single, double8int8
16int16
24int32
MPEG 4 (.m4a, .mp4),
OGG (.ogg)		uint8, int16, int32, single, doubleНет данныхединственный

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

|

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

Была ли эта тема полезной?
Документация MATLAB
Поддержка