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.