audioinfo

Информация о аудио файла

Свернуть все на странице

Синтаксис

info = audioinfo(filename)

Описание

пример

info = audioinfo(filename) Возвраты информацию о содержимом аудио файла, заданную filename.

Примеры

свернуть все

Открыть скрипт

Создайте файл WAVE из файла примера handel.mat, и получите информацию о файле.

Создайте файл WAVE (.wav) в текущей папке.

load handel.mat
filename = 'C:\Temp\handel.wav';
audiowrite(filename,y,Fs);
clear y Fs

Использование audioinfo для возврата информации о файле WAVE.

info = audioinfo(filename)

info = 

  struct with fields:

             Filename: 'C:\Temp\handel.wav'
    CompressionMethod: 'Uncompressed'
          NumChannels: 1
           SampleRate: 8192
         TotalSamples: 73113
             Duration: 8.9249
                Title: []
              Comment: []
               Artist: []
        BitsPerSample: 16

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

свернуть все

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

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

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

Укажите имя файла в filename.

Пример: 'sample_audio.wav'

Другие папки

Если файл находится не в текущей папке или в папке на MATLAB® затем укажите полное или относительное имя пути в filename.

Пример: 'C:\myFolder\myFile.sample_audio.wav'

Пример: 'myFolder\sample_audio.mp3'

URL-адрес Интернета

Если файл задан как однородный интернет-локатор ресурсов (URL), то filename должен содержать тип протокола 'http://' или 'https://'.

Пример: 'http://hostname/path_to_file/sample_audio.mp3'

Удаленное местоположение

Если файл хранится в удаленном местоположении, то filename должен содержать полный путь к файлу, указанному в форме:

scheme_name://path_to_file/ my_file.ext

Исходя из удаленного местоположения, scheme_name может быть одним из значений в этой таблице.

Удаленное местоположениеscheme_name
Амазонки S3™s3
Windows Azure® Хранилище больших двоичных объектовwasb, wasbs
HDFS™hdfs

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

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

Пример: 'myFile.mp3'

Пример: '../myFile.mp3'

Пример: 'C:\temp\myFile.mp3'

audioinfo поддерживает следующие форматы файлов.

Поддержка платформФормат файла
Все платформыВОЛНА (.wav)
OGG (.ogg)
FLAC (.flac)
АУ (.au)
AIFF (.aiff, .aif)
МФЦА (.aifc)
Windows® 7 (или более поздней версии), Macintosh и Linux®MP3 (.mp3)
MPEG-4 AAC (.m4a, .mp4)

На платформах Windows 7 (или более поздней версии), audioinfo также может быть возвращена информация о содержимом любых файлов, поддерживаемых Windows Media® Фундамент.

На платформах Linux, audioinfo также может быть возвращена информация о содержимом любых файлов, поддерживаемых GStreamer.

audioinfo может извлечь аудио метаданные из MPEG-4 (.mp4, .m4v) видео файлов в Windows 7 или более поздней версии, macOS 10.7 Lion или выше, и Linux, и из Windows Media Video (.wmv) и AVI (.avi) файлы на платформах Windows 7 (или более поздней версии) и Linux.

Типы данных: char | string

Выходные аргументы

свернуть все

Информация о аудио файла, возвращенная как структура. info может содержать следующие поля.

Имя поляОписаниеТип данных
FilenameИмя файла, включая абсолютный путь к файлу и расширение файла.character vector
CompressionMethodИспользуется метод сжатия. character vector
NumChannelsКоличество аудиоканалов, закодированных в аудиоканале файла.double
SampleRateЧастота дискретизации аудио данных в файле, в герцах.double
TotalSamplesОбщее количество выборок аудио в файле.double
DurationДлительность файла, в секундах.double
BitsPerSample

Количество бит на выборках, закодированных в аудио файла.

Действителен только для WAVE (.wav) и FLAC (.flac) файлы.

double
BitRate

Количество килобитов в секунду (кбит/с), используемых для сжатого аудио файлов.

Действителен только для MP3 (.mp3) и MPEG-4 Audio (.m4a, .mp4) файлы.

double
TitleЗначение 'Title', если таковые имеются.character vector
ArtistЗначение 'Artist', если таковые имеются.character vector
CommentЗначение 'Comment', если таковые имеются.character vector

Примечание

The BitRate свойство возвращает фактическую скорость передачи битов на платформах Mac, а не закодированную скорость передачи битов. Это означает, что значения скорости передачи битов могут быть ниже, чем задано во время кодирования, в зависимости от исходных данных.

Примечание

На платформах Mac, audioinfo возвращает метаданные из .m4a и .mp4 файлы только на macOS 10.7 Lion или выше. Предыдущие версии macOS не будут читать 'Title', 'Author', или 'Comment' поля.

Ограничения

  • Для MP3 и MPEG-4 аудио файлов AAC на платформах Windows 7 или более поздней версии и Linux, audioinfo может сообщить меньше выборки, чем ожидалось. На платформах Linux это связано с ограничением в базовой среде GStreamer.

  • На платформах Linux, audioinfo интерпретирует одноканальные данные в файлах MPEG-4 AAC как стереоданные.

См. также

|

Введенный в R2012b

Документация MATLAB

Поддержка

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