主要内容

audioDatastore

用于收集音频文件的数据存储

在第页中展开全部

描述

使用audioDatastore对象来管理音频文件的集合，其中每个单独的音频文件都适合内存，但整个音频文件集合不一定适合内存。

创造

语法

广告= audioDatastore(位置)
广告= audioDatastore(位置、名称、值)

描述

例子

广告=音频数据存储(位置）创建一个数据存储广告基于中的音频文件或音频文件集合位置．

例子

广告=音频数据存储(位置，名称,值）使用一个或多个名称-值对参数指定其他属性。

输入参数

全部展开

数据存储中包含的文件或文件夹，指定为路径或DsFileSet对象。

  • 路径-将路径指定为字符向量、字符向量的单元格数组、字符串标量或字符串数组，其中包含文件或文件夹的位置。指定位置作为文件或文件夹的本地路径。如果文件不在当前文件夹中，则本地路径必须指定完整路径或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储中。您可以使用通配符（*）指定本地路径时。此字符指定数据存储包括所有匹配文件或匹配文件夹中的所有文件。

  • DsFileSetobject—你也可以指定位置作为一个DsFileSet对象。有关更多信息，请参见matlab.io.datastore.DsFileSet．

当位置表示文件夹时，该数据存储只包含支持的文件格式，而忽略任何其他格式。万博1manbetx要指定要包含在数据存储中的文件扩展名的自定义列表，请参阅FileExtensions财产。

例子:“song.wav”

例子:“. . / dir /音乐/ song.wav”

例子:{“C: \ dir \ \ song.wav音乐”,“C: \ dir \演讲\ english.mp3”}

例子:“C: \ dir \ \ * . ogg的音乐

数据类型：字符|一串|细胞

名称-值对的观点

指定可选的逗号分隔的对名称,值参数。名字参数名和价值观是对应的值。名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家．

例子:ADS=音频数据存储（'C:\dir\audiodata'、'FileExtensions'、'.ogg'）

子文件夹包含标志，指定为逗号分隔对，由“IncludeSubfolders”和真的或假．指定真的将所有文件和子文件夹包含在每个文件夹或假仅包括每个文件夹中的文件。

如果没有指定“IncludeSubfolders”，则默认值为假．

例子:“IncludeSubfolders”,真的

数据类型：逻辑|双重的

提供标签数据的源，指定为逗号分隔对，由“标签源”和“没有”或“foldernames”.如果“没有”，则标签属性为空。如果“foldernames”，则根据文件夹名称分配标签并存储在标签属性。您可以稍后通过访问标签直接的财产。

数据类型：字符|一串

音频文件扩展名，指定为逗号分隔对，由“FileExtensions”以及字符向量、字符向量的单元数组、字符串标量或字符串数组。如果没有指定“FileExtensions”,然后audioDatastore自动包括所有支持的文件类型:万博1manbetx

  • . wav

  • .avi

  • .aif

  • .aifc

  • 艾夫先生

  • mp3

  • .au

  • .snd

  • mp4

  • .m4a

  • 佛罗里达州

  • .ogg

  • 。mov

例子:“FileExtensions”、“wav”

例子:FileExtensions, {mp3, mp4的}

数据类型：字符|细胞|一串

除了这些名称-值对之外，还可以将该页面上的任何属性指定为名称-值对，但文件夹财产。

性质

全部展开

数据存储中包含的文件，指定为字符向量、字符向量单元格数组、字符串标量或字符串数组。每个字符向量或字符串都是一个文件的完整路径。的位置辩论audioDatastore定义文件夹创建数据存储时。

数据类型：字符|细胞|一串

此属性是只读的。

用于创建音频数据存储的文件夹，作为N-by-1单元格字符向量数组。每一行指定一个包含音频文件的唯一文件夹audioDatastore对象指向。

数据类型：细胞

数据存储中文件的文件标签，指定为向量、单元格数组、字符串数组或表。数组或表中标签的顺序与数据存储中相关文件的顺序相对应。

如果您指定标签源作为“foldernames”在创建audioDatastore对象，则文件的标签名就是包含该文件的文件夹的名称。如果没有指定标签源作为“foldernames”,然后标签是空单元格数组或字符串数组。如果你改变文件夹属性创建数据存储后，则标签属性不会自动更新以合并添加的字段。

数据类型：分类|细胞|逻辑|双重的|单一的|一串|表格

输出数据类型，指定为“双”或“本地人”．

  • “双”——双精度标准化样品。

  • “本地人”——在文件中找到的本地数据类型。指audioread有关数据类型的更多信息OutputDataType设置为本机。

此属性的默认值为“双”．

数据类型：字符|一串

备用文件系统根路径，指定为字符串行向量、字符串向量的单元格数组或字符向量的单元格数组。使用AlternateFileSystemRoots在本地计算机上创建数据存储，但必须访问和处理另一台计算机（可能是不同操作系统）上的数据。此外，在使用并行计算工具箱处理数据时™ 和MATLAB®并行服务器™，并且数据存储在本地机器上，在不同的平台云或集群机器上可以使用数据的副本AlternateFileSystemRoots关联根路径。

  • 若要将一组相互等效的根路径关联起来，请指定AlternateFileSystemRoots作为一个字符串向量。例如:

    ［“Z: \数据集”，“/mynetwork/dataset”］

  • 若要关联与该数据存储相同的多组根路径，请指定AlternateFileSystemRoots作为包含多行的单元格数组，其中每一行表示一组等价的根路径。将单元格数组中的每一行指定为字符串向量或字符向量的单元格数组。例如:

    • 指定AlternateFileSystemRoots作为字符串向量的单元格数组。

      {(“Z: \数据集”，“/mynetwork/dataset”］;...［“Y: \数据集”，“mynetwork2 /数据集”，“年代:\数据集”]}

    • 另外,指定AlternateFileSystemRoots作为字符向量的单元数组的单元数组。

      ｛｛Z: \数据集的，“/mynetwork/dataset”}；...｛“Y:\datasets”/ mynetwork2 /数据集”,“年代:\数据集”｝｝

的价值AlternateFileSystemRoots必须满足以下条件：

  • 包含一个或多个行，其中每一行指定一组等价的根路径。

  • 每行指定多个根路径，每个根路径必须至少包含两个字符。

  • 根路径是唯一的，并且不是彼此的子文件夹。

  • 包含至少一个指向文件位置的根路径条目。

数据类型：字符|细胞|一串

此属性是只读的。

支持的格式编写音万博1manbetx频文件时，使用writeall函数,指定为[“wav”、“flac”、“ogg”、“mp4”、“m4a”]．

数据类型：一串

此属性是只读的。

的默认输出格式，用于编写音频文件时writeall函数,指定为“wav”．

数据类型：一串

对象的功能

读 读下一个连续的音频文件
readall 从数据存储读取所有音频文件
重置 将数据存储读取指针重置为数据的开始
hasdata 如果数据存储中有更多数据则返回true
洗牌 在数据存储中洗牌文件
子集 使用文件子集创建数据存储
预览 从数据存储中读取第一个文件进行预览
进步 读取文件的百分数
splitEachLabel 根据指定的标签比例分割数据存储
计数标签 计数唯一标签的数量
分割 分区数据存储并返回分区部分
数量 用于并行处理的合理分区数的返回估计
结合 合并来自多个数据存储的数据
转型 转换音频数据存储
writeall 将数据存储写入文件
可分割 确定数据存储是否可分区
isShuffleable 确定数据存储是否可洗牌

例子

全部折叠

打开实时脚本

指定audio Toolbox™中包含的音频示例的文件路径。

文件夹= fullfile (matlabroot,“工具箱”，“音频”，“样本”）;

创建指向指定文件夹的音频数据存储。

广告= audioDatastore(文件夹)
ADS=audioDatastore，具有以下属性：文件：{'../build/matlab/toolbox/audio/samples/Ambiance-16-44p1-mono-12secs.wav'；'../matlab/toolbox/audio-array-16-16-4channels-20secs.wav'；'../toolbox/audio/samples/church-pulsereresponse-16-44p1-mono-5secs.wav'…和31个以上的}文件夹：{'/mathworks/devel/bat/Bdoc21a/build/matlab/toolbox/audio/samples'}可选文件系统根：{}输出数据类型：{}双标签：{}支持输出格式：[“wav”“flac”“ogg”“mp4”“m4a”]默认输出格式：“wav”万博1manbetx
打开实时脚本

指定audio Toolbox™中包含的音频示例的文件路径。

文件夹= fullfile (matlabroot,“工具箱”，“音频”，“样本”）;

创建一个音频数据存储，指向.ogg指定文件夹中的文件。

广告= audioDatastore(文件夹,“FileExtension”，. ogg的）
ADS=audioDatastore，具有以下属性：文件：{'/build/matlab/toolbox/audio/samples/FemaleVolumeUp-16-mono-11secs.ogg'；''/bat/Bdoc21a/build/matlab/toolbox/audio/matlab/toolbox/audio/samples/MaleVolumeUp-16-mono-6secs.ogg'；以及另外两个}文件夹：{'/mathworks/devel/bat/Bdoc21a/build/matlab/toolbox/audio/samples'}可选文件系统根：{}输出数据类型：{}双标签：{}支持输出格式：[“wav”“flac”“ogg”“mp4”“m4a”]默认输出格式：“wav”万博1manbetx

另请参阅

||

主题

介绍了R2018b

音频工具箱文档

万博1manbetx

试试MATLAB、Sim万博1manbetxulink和其他产品s manbetx 845

得到审判现在