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

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

свернуть все

Имя файла, заданного как вектор символов или скаляр строки, который включает расширение файла. Если путь задан, это может быть абсолютным, относительным, или частичным.

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

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

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

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

Поддержка платформFileFormat
Все платформыWAVE (.wav)
OGG (.ogg)
FLAC (.flac)
AU (.au)
AIFF (.aiff, .aif)
AIFC (.aifc)
Windows® 7 (или позже), Macintosh и Linux®MP3 (.mp3)
MPEG-4 AAC (.m4a, .mp4)

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

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

audioinfo может извлечь аудио метаданные от MPEG-4 (.mp4, .m4v) видеофайлы на Windows 7 или позже, лев macOS 10.7 или выше, и 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 или выше. Предыдущие версии macOS не считают 'Title', 'Author' или поля 'Comment'.

Ограничения

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

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

Смотрите также

|

Представленный в R2012b