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.