主要内容

audioread

读取音频文件

描述

例子

yFs= audioread(文件名从指定的文件读取数据文件名,返回采样数据,y,以及该数据的抽样率,Fs

例子

yFs= audioread(文件名样品读取文件中所选音频样本范围,其中样品是这个形式的向量吗(开始、结束)

例子

yFs= audioread(___数据类型属性对应的数据范围内的采样数据数据类型“本地”“双”,并且可以包括以前语法中的任何输入参数。

例子

全部折叠

从示例文件创建一个WAVE文件handel.mat,并将文件读入MATLAB®。

创造一个波(. wav)文件。

负载handel.mat文件名=“handel.wav”;audiowrite(文件名,y, Fs);清晰的yFs

读取数据回MATLAB使用audioread

[y,Fs] = audioread(“handel.wav”);

播放音频。

声音(y, Fs);

从示例文件创建FLAC文件handel.mat,然后只读前2秒。

创建FLAC (.flac)文件。

负载handel.mat文件名=“handel.flac”;audiowrite(文件名,y, Fs);

只读前2秒。

样本= [1,2*Fs];清晰的yFs[y,Fs] = audioread(文件名,样本);

播放样本。

声音(y, Fs);

创建一个.flac文件,读取文件的前2秒,然后以本机整数格式返回音频。

创建FLAC (.flac)文件。

负载handel.mat文件名=“handel.flac”;audiowrite(文件名,y, Fs);

读取前2秒,指定数据,查看采样数据y的数据类型y

样本= [1,2*Fs];清晰的yFs[y,Fs] = audioread(文件名,样本);谁y
名称大小字节类属性y 16384x1 131072 double

请求文件原生格式的音频数据,然后查看采样数据的数据类型y.注意新的数据类型y

[y,Fs] = audioread(文件名,“本地”);谁y
名称大小字节类属性y 73113x1 146226 int16

输入参数

全部折叠

要读取的文件名称,指定为包含文件扩展名的字符向量或字符串标量。

根据文件的位置,文件名可以变成这些形式之一。

当前文件夹

中指定文件的名称文件名

例子:“sample_audio.wav”

其他文件夹

如果文件不在当前文件夹中或不在MATLAB的文件夹中®路径,然后在中指定完整或相对路径名文件名

例子:“C: \ myFolder \ myFile.sample_audio.wav”

例子:“myFolder \ sample_audio.mp3”

互联网网址

如果文件指定为internet统一资源定位符(URL),则文件名必须包含协议类型“http://”“https://”

例子:“http://hostname/path_to_file/sample_audio.mp3”

远程位置

如果文件存储在远程位置,则文件名必须包含由表单指定的文件的完整路径:

scheme_name://path_to_file/my_file.ext

根据位置的远近scheme_name可以是本表中的值之一。

远程位置 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasbwasbs
HDFS™ hdfs

有关更多信息,请参见使用远程数据

例子:s3: / / bucketname / path_to_file / sample_audio.mp3 '

例子:“myFile.mp3”

例子:“. . / myFile.mp3”

例子:“C: \ temp \ myFile.mp3”

audioread金宝app支持以下文件格式。

平台支持金宝app 文件格式
所有平台 AIFC (.aifc
AIFF (.aiffaif
非盟(.au
FLAC (.flac
OGG (. ogg
作品(.opus
波(. wav
窗户®7(或更高版本),麦金塔电脑、Linux操作系统® MP3 (mp3
Mpeg-4 aac (.m4amp4

在Windows 7之前的Windows平台上,audioread不读取带有MP3编码数据的WAVE文件。

在Windows 7(或更高版本)平台上,audioread也可以读取Windows Media支持的任何文件金宝app®的基础。

在Linux平台上,audioread也可以读取GStreamer支持的任何文件。金宝app

audioread可以从MPEG-4提取音频(mp4.m4v)视频档案Windows 7或之后,麦金塔电脑,和Linux,以及从windowsmediavideo (.wmv)和AVI (.aviWindows 7(或更高版本)和Linux平台上的文件。

数据类型:字符|字符串

要读取的音频样本,指定为两元素矢量的形式(开始、结束),在那里开始而且完成是要读取的第一个和最后一个样本,并且是正标量整数。

  • 开始必须小于或等于完成

  • 开始而且完成必须小于文件中音频样本的数量,

  • 你可以使用以指示文件中的最后一个示例。

请注意

在阅读部分MP3文件时Windows 7平台,audioread可能会读取移位的样本范围。这是由于底层Windows Media Foundation框架的限制。

在Linux平台上阅读部分MP3和M4A文件时,audioread可能会读取移位的样本范围。这是由于底层GStreamer框架中的一个限制。

例子:[1100]

数据类型:

音频数据数据格式,y,指定为以下其中之一:

“双” 双精度归一化样本。
“本地” 在文件中找到的本地格式的示例。

对于压缩音频格式,例如MP3和MPEG-4 AAC,它们不以整数形式存储数据,“本地”默认为“单一”

数据类型:字符|字符串

输出参数

全部折叠

音频数据在文件中,返回为——- - - - - -n矩阵,音频样本的数量是否已读取和n文件中的音频通道数。

  • 如果您没有指定数据类型,或数据类型“双”,然后y是类型的,矩阵元素为−1.0 ~ 1.0之间的归一化值。

  • 如果数据类型“本地”,然后y可以是几种MATLAB数据类型之一,这取决于文件格式和BitsPerSample的值。调用audioinfo要确定BitsPerSample文件的值。

    文件格式 BitsPerSample y的数据类型 y的数据范围
    波(. wav 8 uint8 0≤y≤255
    16 int16 -32768年≤y≤+ 32767
    24 int32 2 ^ 31≤y≤2 ^还有
    32 int32 2 ^ 31≤y≤2 ^还有
    32 -1.0≤y≤1.0 +
    64 -1.0≤y≤1.0 +
    波(. wav) (u-law) 8 int16 -32124年≤y≤+ 32124
    波(. wav)(法) 8 int16 -32256年≤y≤+ 32256
    FLAC (.flac 8 uint8 0≤y≤255
    16 int16 -32768年≤y≤+ 32767
    24 int32 2 ^ 31≤y≤2 ^还有
    MP3 (mp3), mpeg-4 aac (.m4amp4), ogg (. ogg), opus (.opus),以及某些压缩的WAVE文件 N/A -1.0≤y≤1.0 +

请注意

在哪里yBitsPerSample是32还是64,值在y可能超过−1.0或+1.0。

音频数据的采样率,以赫兹为单位y,作为正标量返回。

限制

  • 适用于MP3、MPEG-4 AAC和AVI音频文件Windows 7或更高版本的Linux平台,audioread可能读取的样本比预期的少。在Windows 7这是由于底层媒体基金会框架的限制。在Linux平台上,这是由于底层GStreamer框架的限制。如果您需要精确的样本读取,请使用WAV或FLAC文件。

  • 在Linux平台上,audioread将包含单通道数据的MPEG-4 AAC文件读取为立体声数据。

扩展功能

版本历史

在R2012b中引入