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
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, wasbs
HDFS™hdfs

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

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

Пример: '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
Для просмотра документации необходимо авторизоваться на сайте