Exponenta Banner
exponenta event banner

audioinfo

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

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

Синтаксис

info = audioinfo (имя файла)

Описание

пример

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)
FLAC (ПОЗ..flac)
AU (.au)
AIFF (.aiff, .aif)
МФЦА (.aifc)
Windows ® 7 (или более поздняя версия), Macintosh и Linux ®MP3 (.mp3)
MPEG-4 КРК (.m4a, .mp4)

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

На платформах 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 Аудио (.m4a, .mp4) файлы.

double
TitleЗначение 'Title', если есть.character vector
ArtistЗначение 'Artist', если есть.character vector
CommentЗначение 'Comment', если есть.character vector

Примечание

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

Поддержка