主要内容

audioplayer

播放音频的对象

描述

使用一个audioplayer对象播放音频数据。对象包含在回放过程中提供额外灵活性的属性。方法可以暂停、恢复或定义回调audioplayer对象的功能。

创建

描述

例子

球员= audioplayer (YFs创建一个audioplayer用于信号的对象Y,使用抽样率Fs.函数返回音频播放器对象,球员

例子

球员= audioplayer (YFsnBits使用nBits信号的每样本位Y

例子

球员= audioplayer (YFsnBitsID使用标识的音频设备ID为输出。

例子

球员= audioplayer (录音机创建一个audioplayer对象使用音频记录器对象录音机

例子

球员= audioplayer (录音机ID从创建对象录音机所识别的音频设备ID为输出。

输入参数

全部展开

音频信号,指定为数值数据的矢量或二维数组。

输入样例的取值范围取决于数据类型。

数据类型

采样值范围

int8

-128 ~ 127

uint8

0 ~ 255

int16

-32768 ~ 32767

-1到1

-1到1

数据类型:||int8|int16|uint8

采样频率,以赫兹(Hz)为单位,指定为数值标量。

采样率的有效值取决于MATLAB允许的两个采样率®以及系统上的特定音频硬件。MATLAB的硬限制为1000hz <=Fs<= 384000 Hz,尽管还存在进一步的硬件限制。大多数声卡支持的典型值为800金宝app0、11025、22050、44100、48000和96000赫兹。

数据类型:|

每个样本的位,指定为816,或24

指定nBits只有当信号Y包含浮点值。的有效值nBits取决于音频硬件。例如,根据你的音频硬件,nBits可以是以下值之一:816,或24

设备标识符,指定为整数。

设备ID可以通过audiodevinfo函数。

对象,指定为audiorecorder对象。使用audiorecorder函数创建对象。

属性

全部展开

此属性是只读的。

每个样本的比特数,作为正整数返回。

此属性是只读的。

当前在音频输出设备上播放的示例,返回为正整数。

如果设备没有播放,那么CurrentSample下一个样本是玩用的吗重新开始方法。

此属性是只读的。

音频设备标识符,以整数形式返回。

此属性是只读的。

音频通道数,返回为12

此属性是只读的。

音频播放器状态,返回为

采样频率,以赫兹(Hz)为单位,以数字标量返回。

设置SampleRate,使用Fs属性时的Input参数audioplayer对象。

此属性是只读的。

样本中音频数据的总长度,以整数形式返回。

标签,指定为字符向量。

此属性是只读的。

对象类名,返回为“audioplayer”

用户定义的数据,指定为任何数据类型的值。使用此属性可存储对象中的任何其他数据。

函数,指定为字符向量或包含函数名称的字符串标量,或函数句柄。

回调函数的前两个输入必须是audioplayer对象和事件结构。有关更多信息,请参见回调函数

函数,指定为字符向量或包含函数名称的字符串标量,或函数句柄。

回调函数的前两个输入必须是audioplayer对象和事件结构。有关更多信息,请参见回调函数

函数在播放期间重复执行,指定为字符向量或包含函数名称的字符串标量,或函数句柄。要指定重复的时间间隔,请使用TimerPeriod财产。

回调函数的前两个输入必须是audioplayer对象和事件结构。有关更多信息,请参见回调函数

定时器周期,指定为数值标量。

定时器周期为间隔时间,单位为秒TimerFcn回调。

对象的功能

得到 查询属性值audioplayer对象
isplaying 确定回放是否正在进行
暂停 暂停播放或录制
播放音频audioplayer对象
playblocking 播放音频audioplayer对象时,按住控制键直到播放完成
重新开始 从暂停状态恢复播放或录制
设置属性值audioplayer对象
停止 停止回放或录音

例子

全部折叠

加载并播放示例音频文件。

负载handel.mat进入工作区。该文件包含一个示例音频数据数组y以及抽样率Fs

负载(“handel.mat”)谁yFs
名称大小字节类属性Fs 1x1 8 double y 73113x1 584904 double

创建一个audioplayer对象来播放文件。

player = audioplayer(y,Fs);

在默认音频设备上播放音频对象。

玩(球员);

通过麦克风录制音频数据,然后播放录制的音频。

创建一个audiorecorder具有默认属性值的对象。

recObj =录音机;

用麦克风录一段5秒的演讲。

disp (开始说话。
开始说话。
recordblocking (recObj 5);disp (“录音结束。”);
录制结束。

根据录音创建音频播放器对象,然后播放录制的示例。

playerObj = audioplayer(recObj);玩(playerObj);

限制

  • 这些限制适用于使用audioplayerMATLAB在线™MATLAB Web应用程序服务器™

    • 您不能创建audioplayer对象的录音机对象。

    • 你不能改变一个已经存在的样本率audioplayer对象。

    • audioplayer忽略了nBits.相反,它使用输出音频设备的每个样本的默认位数来播放音频数据。

更多关于

全部展开

提示

  • 音频回放MATLAB在线而且MATLAB Web应用服务器谷歌Ch金宝approme™支持。

版本历史

R2006a之前介绍