audioread

读取音频文件

全页折叠

语法

[y,Fs] = audioread(filename)

[y,Fs] = audioread(filename,samples)

[y,Fs] = audioread(___,dataType)

说明

示例

[y,Fs] = audioread(filename) 从名为 filename 的文件中读取数据，并返回样本数据 y 以及该数据的采样率 Fs。

示例

[y,Fs] = audioread(filename,samples) 读取文件中所选范围的音频样本，其中 samples 是 [start,finish] 格式的向量。

示例

[y,Fs] = audioread(___,dataType) 返回数据范围内与 dataType（'native' 或 'double'）对应的采样数据，可包含上述语法中的任何输入参数。

示例

全部折叠

读取完整的音频文件

打开脚本

从示例文件 handel.mat 创建 WAVE 文件，并将此文件读回 MATLAB®。

在当前文件夹中创建 WAVE (.wav) 文件。

load handel.mat

filename = 'handel.wav';
audiowrite(filename,y,Fs);
clear y Fs

使用 audioread 将数据读回 MATLAB。

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

播放音频。

sound(y,Fs);

读取部分音频文件

打开脚本

从示例文件 handel.mat 创建 FLAC 文件，然后仅读取前 2 秒的内容。

在当前文件夹中创建 FLAC (.flac) 文件。

load handel.mat

filename = 'handel.flac';
audiowrite(filename,y,Fs);

仅读取前 2 秒的内容。

samples = [1,2*Fs];
clear y Fs
[y,Fs] = audioread(filename,samples);

播放样本。

sound(y,Fs);

返回原生整数格式的音频

打开脚本

创建一个 .flac 文件，读取文件的前 2 秒内容，然后返回原生整数格式的音频。

在当前文件夹中创建 FLAC (.flac) 文件。

load handel.mat
filename = 'handel.flac';
audiowrite(filename,y,Fs);

仅读取前 2 秒内容，然后指定数据并查看采样数据 y 的数据类型。y 的数据类型为 double。

samples = [1,2*Fs];
clear y Fs
[y,Fs] = audioread(filename,samples);
whos y

  Name          Size             Bytes  Class     Attributes

  y         16384x1             131072  double

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

[y,Fs] = audioread(filename,'native');
whos y

  Name          Size             Bytes  Class    Attributes

  y         73113x1             146226  int16

输入参数

全部折叠

`filename` — 要读取的文件的名称
字符向量 | 字符串标量

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

根据文件的位置，filename 可以采用下列形式之一。

当前文件夹

指定 filename 中文件的名称。

示例：'sample_audio.wav'

其他文件夹

如果该文件不在当前文件夹或 MATLAB^® 路径下的文件夹中，则在 filename 中指定完整或相对路径名。

示例：'C:\myFolder\myFile.sample_audio.wav'

示例：'myFolder\sample_audio.mp3'

Internet URL

如果文件指定为 Internet 统一资源定位器 (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^® Blob 存储	`wasb`, `wasbs`
HDFS™	`hdfs`

有关详细信息，请参阅处理远程数据。

示例：'s3://bucketname/path_to_file/sample_audio.mp3'

示例： 'myFile.mp3'

示例： '../myFile.mp3'

示例： 'C:\temp\myFile.mp3'

audioread 支持以下文件格式。

平台支持	文件格式
所有平台	AIFC (`.aifc`)
	AIFF（`.aiff`、`.aif`）
	AU (`.au`)
	FLAC (`.flac`)
	OGG (`.ogg`)
	OPUS (`.opus`)
	WAVE (`.wav`)
Windows^® 7（或更高版本）、Macintosh 和 Linux^®	MP3 (`.mp3`)
Windows^® 7（或更高版本）、Macintosh 和 Linux^®	MPEG-4 AAC（`.m4a`、`.mp4`）

在低于 Windows 7 的 Windows 平台上，audioread 不读取包含 MP3 编码数据的 WAVE 文件。

在 Windows 7（或更高版本）平台中，audioread 可能还读取 Windows Media^® Foundation 支持的任何文件。

在 Linux 平台中，audioread 可能还读取 GStreamer 支持的任何文件。

audioread 可以从 Windows 7 或更高版本、Macintosh 和 Linux 上的 MPEG-4（.mp4、.m4v）视频文件、从 Windows 7（或更高版本）和 Linux 平台上的 Windows Media 视频 (.wmv) 和 AVI (.avi) 文件中提取音频。

数据类型： char | string

`samples` — 要读取的音频样本
`[1,inf]` （默认） | 正整数标量的二元素向量

要读取的音频样本，指定为 [start,finish] 形式的二元素向量，其中 start 和 finish 是要读取的第一个和最后一个样本，是正整数标量。

start 必须小于或等于 finish。
start 和 finish 必须小于文件中的音频样本数，
可以使用 inf 指示文件中的最后一个样本。

注意

在 Windows 7 平台上读取某些 MP3 文件的部分内容时，audioread 可能会读取不同范围的样本。这是由于基础 Windows Media Foundation 框架的局限性所致。

在 Linux 平台上读取某些 MP3 和 M4A 文件的部分内容时，audioread 可能会读取不同范围的样本。这是由于基础 GStreamer 框架的局限性所致。

示例： [1,100]

数据类型： double

`dataType` — 音频数据 `y` 的数据格式
`'double'` （默认） | `'native'`

音频数据 y 的数据格式，指定为以下值之一：

`'double'`	双精度的归一化样本。
`'native'`	在文件中找到的原生格式的样本。

对于已压缩的音频格式，例如未按照整数格式存储数据的 MP3 和 MPEG-4 AAC，'native' 默认为 'single'。

数据类型： char | string

输出参数

全部折叠

`y` — 音频数据
矩阵

文件中的音频数据，返回为 m×n 矩阵，其中 m 是读取的音频样本数，n 是文件中的音频通道数。

如果未指定 dataType，或者 dataType 为 'double'，则 y 为 double 类型，矩阵元素是介于 −1.0 和 1.0 之间的归一化值。

如果 dataType 是 'native'，则 y 可以是多个 MATLAB 数据类型之一，具体取决于输入文件的文件格式和 BitsPerSample 值。调用 audioinfo 以确定文件的 BitsPerSample 值。

文件格式	BitsPerSample	y 的数据类型	y 的数据范围
WAVE (`.wav`)	8	`uint8`	0 ≤ `y` ≤ 255
	16	`int16`	-32768 ≤ `y` ≤ +32767
	24	`int32`	-2^31 ≤ `y` ≤ 2^31–1
	32	`int32`	-2^31 ≤ `y` ≤ 2^31–1
	32	`single`	-1.0 ≤ `y` ≤ +1.0
	64	`double`	-1.0 ≤ `y` ≤ +1.0
WAVE (`.wav`) (u-law)	8	`int16`	-32124 ≤ `y` ≤ +32124
WAVE (`.wav`) (A-law)	8	`int16`	-32256 ≤ `y` ≤ +32256
FLAC (`.flac`)	8	`uint8`	0 ≤ `y` ≤ 255
	16	`int16`	-32768 ≤ `y` ≤ +32767
	24	`int32`	-2^31 ≤ `y` ≤ 2^31–1
MP3 (`.mp3`)、MPEG-4 AAC (`.m4a`、`.mp4`)、OGG (`.ogg`)、OPUS (`.opus`) 和某些压缩的 WAVE 文件	不适用	`single`	-1.0 ≤ `y` ≤ +1.0

注意

其中，y 是 single 或 double，BitsPerSample 是 32 或 64，y 中的值可能会超过 −1.0 或 +1.0。

`Fs` — 采样率
正标量

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

局限性

对于 Windows 7 或更高版本和 Linux 平台上的 MP3、MPEG-4 AAC 和 AVI 音频文件，audioread 读取的样本数量可能比预期的少。在 Windows 7 平台上，这是由于基础 Media Foundation 框架所致。在 Linux 平台上，这是由于基础 GStreamer 框架的局限性所致。如果需要精确的样本读取，请使用 WAV 或 FLAC 文件。
在 Linux 平台上，audioread 读取包含用作立体声数据的单通道数据的 MPEG-4 AAC 文件。

扩展功能

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

版本历史记录

在 R2012b 中推出

全部展开

R2022a: 读取 Opus (`.opus`) 音频文件

您可以读取 Ogg Opus 音频文件。

R2021b: 支持基于线程的环境

您可以使用 MATLAB backgroundPool 在后台运行 audioread。

R2021a: 从 HTTP 或 HTTPS URL 读取音频文件

您可以通过将 filename 指定为包含协议类型 'http://' 或 'https://' 的字符串或字符向量，从 Internet URL 读取音频文件。

R2020b: 从远程位置读取音频文件

您可以读取存储在远程位置（如 Amazon S3、Windows Azure Blob 储存和 HDFS）的音频文件。

另请参阅

audiowrite | audioinfo | 导入数据

主题

读取和写入音频文件

audioread

语法

说明

示例

读取完整的音频文件

读取部分音频文件

返回原生整数格式的音频

输入参数

filename — 要读取的文件的名称 字符向量 | 字符串标量

samples — 要读取的音频样本 [1,inf] （默认） | 正整数标量的二元素向量

dataType — 音频数据 y 的数据格式 'double' （默认） | 'native'

输出参数

y — 音频数据 矩阵

Fs — 采样率 正标量

局限性

扩展功能

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

R2022a: 读取 Opus (.opus) 音频文件

R2021b: 支持基于线程的环境

R2021a: 从 HTTP 或 HTTPS URL 读取音频文件

R2020b: 从远程位置读取音频文件

另请参阅

主题

WeChat

`filename` — 要读取的文件的名称
字符向量 | 字符串标量

`samples` — 要读取的音频样本
`[1,inf]` （默认） | 正整数标量的二元素向量

`dataType` — 音频数据 `y` 的数据格式
`'double'` （默认） | `'native'`

`y` — 音频数据
矩阵

`Fs` — 采样率
正标量

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

R2022a: 读取 Opus (`.opus`) 音频文件