audioplayer

播放音频的对象

在页面中全部展开

描述

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

创建

语法

球员= audioplayer (Y, Fs)

球员= audioplayer (Y, Fs, nBits)

球员= audioplayer (Y, Fs, nBits ID)

球员= audioplayer(录音机)

球员= audioplayer(录音机,ID)

描述

例子

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

球员= audioplayer (Y，Fs，nBits）使用nBits每采样位为信号Y．

球员= audioplayer (Y，Fs，nBits，ID）使用识别的音频设备ID为输出。

例子

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

球员= audioplayer (录音机，ID）从创建对象录音机它使用的音频设备由ID为输出。

输入参数

全部展开

`Y`- - - - - -音频信号
向量|数组

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

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

数据类型	样本值范围
`int8`	-128年到127年
`uint8`	0到255
`int16`	-32768年到32767年
`单`或`双`	1到1

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

`Fs`- - - - - -采样率
积极的标量

以赫兹(Hz)为单位的采样率，指定为正标量。

采样率的有效值取决于系统的音频硬件。大多数设置支持的典型采样率是8000、11025、22050、44100、48,000、96,000和192,000 Hz。

此参数设置SampleRate财产。

数据类型:单|双

`nBits`- - - - - -位/样本
`16`(默认)|`8`|`24`

每个样本的比特数，指定为16，8,或24．指定nBits仅当信号包含浮点值时。

有效的值nBits这取决于系统的音频硬件。

此参数设置BitsPerSample财产。

`ID`- - - - - -音频设备标识符
`－1`(默认)|整数

音频设备标识符，指定为整数。

要获取设备的ID，请使用audiodevinfo函数。

此参数设置的DeviceID财产。

`录音机`- - - - - -录音机对象
`audiorecorder`对象

音频记录器对象，指定为audiorecorder对象。使用audiorecorder函数创建对象。

属性

全部展开

`SampleRate`- - - - - -采样率
积极的标量

以赫兹(Hz)为单位的采样率，指定为正标量。

设置SampleRate属性初始时，使用Fs类时的输入参数audioplayer对象。创建对象后，可以修改其SampleRate财产。

`BitsPerSample`- - - - - -位/样本
`8`|`16`|`24`

此属性是只读的。

每个样本的比特数，返回为8，16,或24．

设置BitsPerSample属性,使用nBits类时的输入参数audioplayer对象。

`NumChannels`- - - - - -音频通道数量
`1`|`2`

此属性是只读的。

音频通道数量，返回为1(mono)或2(立体)。

`的DeviceID`- - - - - -音频设备标识符
整数

此属性是只读的。

音频设备标识符，作为整数返回。

设置的DeviceID属性,使用ID类时的输入参数audioplayer对象。

`CurrentSample`- - - - - -样品目前玩
正整数

此属性是只读的。

当前在音频输出设备上播放的样本，作为正整数返回。

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

`TotalSamples`- - - - - -音频数据的总长度
非负整数

此属性是只读的。

样本中音频数据的总长度，作为非负整数返回。

`运行`- - - - - -音频播放器状态
`“关闭”`(默认)|`“上”`

此属性是只读的。

音频播放器状态，返回为“关闭”或“上”．

`StartFcn`- - - - - -函数在启动时执行
特征向量|函数处理

函数在回放开始时执行，指定为包含函数名或函数句柄的字符向量。

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

`StopFcn`- - - - - -函数在结束时执行
特征向量|函数处理

函数在回放结束时执行，指定为包含函数名或函数句柄的字符向量。

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

`TimerFcn`- - - - - -函数重复执行
特征向量|函数处理

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

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

`TimerPeriod`- - - - - -定时器周期
`0.05`(默认)|积极的标量

计时器周期，指定为正标量。

TimerPeriod时间是以秒为单位的吗TimerFcn回调。

`标签`- - - - - -标签
字符串标量|特征向量

标签，指定为字符串标量或字符向量。

`用户数据`- - - - - -用户定义的数据
`［］`(默认)|任何数据类型

用户定义的数据，指定为任意数据类型的值。使用此属性可将任何附加数据与对象一起存储。

`类型`- - - - - -对象类名
`“audioplayer”`(默认)

此属性是只读的。

对象类名，返回为“audioplayer”．

对象的功能

`得到`	查询属性值`audioplayer`对象
`isplaying`	确定是否正在进行回放
`暂停`	暂停播放`audioplayer`的对象或记录`audiorecorder`对象
`玩`	播放音频的`audioplayer`对象
`playblocking`	播放音频的`audioplayer`对象;保持控制直到播放完成
`重新开始`	恢复播放`audioplayer`的对象或记录`audiorecorder`对象的暂停状态
`集`	设置属性值`audioplayer`对象
`停止`	停止播放`audioplayer`的对象或记录`audiorecorder`对象

例子

全部折叠

播放音频文件

打开生活的脚本

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

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

负载handel.mat谁yFs

名称大小字节类属性Fs 1x1 8 double y 7313x1 584904 double

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

球员= audioplayer (y, Fs);

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

玩(球员);

录制和播放音频样本

打开生活的脚本

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

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

recObj = audiorecorder;

用你的麦克风录下5秒的声音样本。

disp (“开始。”）

开始说话。

recDuration = 5;%记录5秒recordblocking (recObj recDuration);disp (“结束记录。”）

结束录音。

从录音创建一个音频播放器对象，然后播放录制的示例。

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

限制

这些限制适用于使用时audioplayer在MATLAB^®在线™或MATLAB Web应用服务器™：
- 您不能创建audioplayer对象从一个audiorecorder对象。
- 不能更改现有的audioplayer对象。
- audioplayer忽略了nBits．相反，它使用输出音频设备的每个样本的默认位数播放音频数据。
- 采样率的有效值Fs可能与MATLAB桌面中的不一样。

提示

的audioplayer函数支持所有Windows上的声音设备^®和大多数UNIX^®平台。
audioplayer在MATLAB在线而且MATLAB Web应用服务器在谷歌Chrome™中支持。
请注意

使用时的安全注意事项MATLAB在线或MATLAB Web应用服务器：当使用audioplayer在MATLAB在线或MATLAB Web应用服务器，某些功能和设置可以帮助你控制你的隐私。

为了减少不必要的应用程序使用您的麦克风的可能性，请关闭对音频设备的自动访问。您可以在任何时候更改这些设置。在授予一个网站一次权限后，您的浏览器可能能够在以后访问该网站时自动访问您的麦克风。使用浏览器设置谷歌Chrome在您最初获准访问特定网站后撤销对该网站的访问。

您也可以访问MATLAB在线网站或MATLAB Web应用服务器使用私隐浏览模式谷歌Chrome．当您这样做，Chrome™自动要求您的权限访问您的麦克风，每次您打开MATLAB在线网站或MATLAB Web应用服务器和运行audioplayer，无论您的浏览器设置如何。

版本历史

之前介绍过的R2006a

另请参阅

audiodevinfo|audiorecorder|声音

audioplayer

描述

创建

语法

描述

输入参数

Y- - - - - -音频信号向量|数组

Fs- - - - - -采样率积极的标量

nBits- - - - - -位/样本16(默认)|8|24

ID- - - - - -音频设备标识符－1(默认)|整数

录音机- - - - - -录音机对象audiorecorder对象

属性

SampleRate- - - - - -采样率积极的标量

BitsPerSample- - - - - -位/样本8|16|24

NumChannels- - - - - -音频通道数量1|2

的DeviceID- - - - - -音频设备标识符整数

CurrentSample- - - - - -样品目前玩正整数

TotalSamples- - - - - -音频数据的总长度非负整数

运行- - - - - -音频播放器状态“关闭”(默认)|“上”

StartFcn- - - - - -函数在启动时执行特征向量|函数处理

StopFcn- - - - - -函数在结束时执行特征向量|函数处理

TimerFcn- - - - - -函数重复执行特征向量|函数处理

TimerPeriod- - - - - -定时器周期0.05(默认)|积极的标量

标签- - - - - -标签字符串标量|特征向量

用户数据- - - - - -用户定义的数据［］(默认)|任何数据类型

类型- - - - - -对象类名“audioplayer”(默认)

对象的功能

例子

播放音频文件

录制和播放音频样本

限制

提示

版本历史

另请参阅

主题

`Y`- - - - - -音频信号
向量|数组

`Fs`- - - - - -采样率
积极的标量

`nBits`- - - - - -位/样本
`16`(默认)|`8`|`24`

`ID`- - - - - -音频设备标识符
`－1`(默认)|整数

`录音机`- - - - - -录音机对象
`audiorecorder`对象

`SampleRate`- - - - - -采样率
积极的标量

`BitsPerSample`- - - - - -位/样本
`8`|`16`|`24`

`NumChannels`- - - - - -音频通道数量
`1`|`2`

`的DeviceID`- - - - - -音频设备标识符
整数

`CurrentSample`- - - - - -样品目前玩
正整数

`TotalSamples`- - - - - -音频数据的总长度
非负整数

`运行`- - - - - -音频播放器状态
`“关闭”`(默认)|`“上”`

`StartFcn`- - - - - -函数在启动时执行
特征向量|函数处理

`StopFcn`- - - - - -函数在结束时执行
特征向量|函数处理

`TimerFcn`- - - - - -函数重复执行
特征向量|函数处理

`TimerPeriod`- - - - - -定时器周期
`0.05`(默认)|积极的标量

`标签`- - - - - -标签
字符串标量|特征向量

`用户数据`- - - - - -用户定义的数据
`［］`(默认)|任何数据类型

`类型`- - - - - -对象类名
`“audioplayer”`(默认)