33.1 Служебные утилиты для аудиофайлов

Следующие функции позволяют вам читать, записывать и извлекать информацию об аудиофайлах. Поддерживаются различные форматы, включая wav, flac и ogg vorbis.

info = audioinfo (filename)

Возвращает информацию об аудиофайле, указанном в filename.

Вывод info — это структура, содержащая следующие поля:

‘Filename’

Имя аудиофайла.

‘CompressionMethod’

Метод сжатия аудио. Не используется, присутствует только для совместимости с MATLAB.

‘NumChannels’

Количество аудиоканалов.

‘SampleRate’

Частота дискретизации аудио в герцах.

‘TotalSamples’

Количество выборок в файле.

‘Duration’

Продолжительность аудио в секундах.

‘BitsPerSample’

Количество бит на выборку.

‘BitRate’

Битрейт аудио. Не используется, присутствует только для совместимости с MATLAB.

‘Title’

"Title" значение аудиометаданных в виде строки или пустая строка, если отсутствует.

‘Artist’

"Artist" значение аудиометаданных в виде строки или пустая строка, если отсутствует.

‘Comment’

"Comment" значение аудиометаданных в виде строки или пустая строка, если отсутствует.

См. также: audioread, audiowrite.

[y, fs] = audioread (filename)

[y, fs] = audioread (filename, samples)

[y, fs] = audioread (filename, datatype)

[y, fs] = audioread (filename, samples, datatype)

Читает аудиофайл filename и возвращает аудиоданные y и частоту дискретизации fs.

Аудиоданные хранятся в виде матрицы, где строки соответствуют аудиокадрам, а столбцы — каналам.

Необязательный двумерный вектор samples указывает начальный и конечный кадры.

Необязательный аргумент datatype указывает тип данных для возврата. Если это "native", то тип данных зависит от того, как данные хранятся в аудиофайле.

См. также: audiowrite, audioformats, audioinfo.

audiowrite (filename, y, fs)

audiowrite (filename, y, fs, name, value, …)

Записывает аудиоданные из матрицы y в filename с частотой дискретизации fs с форматом файла, определяемым расширением файла.

Дополнительные аргументы имя/значение могут быть использованы для указания следующих опций:

‘BitsPerSample’

Количество бит на выборку. Допустимые значения: 8, 16, 24 и 32. По умолчанию 16.

‘BitRate’

Допустимое имя аргумента, но игнорируется. Сохранено для совместимости с MATLAB.

‘Quality’

Уровень качества для сжатия Ogg Vorbis. Значения могут изменяться от 0 до 100, при этом 100 — наивысший уровень качества. По умолчанию 75.

‘Title’

Название аудиофайла.

‘Artist’

Имя исполнителя.

‘Comment’

Комментарий.

См. также: audioread, audioformats, audioinfo.

audioformats ()

audioformats (format)

Отображает информацию обо всех поддерживаемых форматах аудио.

Если необязательный аргумент format задан, отображаются только форматы, имена которых начинаются с format.

См. также: audioread, audiowrite.