使用小组件 > 2D > 音频
  
音频
这个小组件有什么功能?
“音频”小组件允许您在体验中播放音频文件。支持的文件格式包括:
.wav
.mp3
.mp4
何时会用到这个小组件?
在以下情况下,会用到“音频”小组件:
想要在体验中加入音频。
体验需要用户用双手来完成任务。例如,如果维修技师要更换发电机上的机油,则其可播放操作步骤的音频,而不必在设备上阅读,或翻阅纸质手册。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
下表列出了这个小组件的专用属性、服务和事件。
属性
JavaScript
类型
说明
音频源
audiosrc
string
若要加入音频,您可以执行以下操作之一:
点击字段旁边的 添加新的音频文件。
输入音频 URL 或者将其直接复制粘贴到字段中。
从下拉菜单中选择音频文件。
有关如何关联远程媒体的信息,请参阅链接远程媒体
显示控件
showcontrols
boolean
选择是否显示控件。
预加负载
preload
string
选择要预加负载的内容:
内容
仅元数据
正在播放
isPlaying
boolean
表示是否正在播放音频。
服务
JavaScript
说明
播放
play
用于播放音频的可绑定服务。
暂停
pause
用于暂停音频的可绑定服务。
事件
JavaScript
说明
播放已开始
playStarted
音频开始时,将触发此事件。
播放已暂停
playPaused
音频暂停时,将触发此事件。
播放已结束
playEnded
音频结束时,将触发此事件。
小组件的显示效果
以下是小组件的显示效果示例!
使用时的必要步骤
显示效果
1. “音频”小组件拖放到工作区中。
2. “音频源”字段中选择或添加音频资源。
* 
在本示例中,我们选择了在打开体验后立即显示内容,其设置方法如下:在“详细信息”窗格的“预先加载”下拉菜单中选择“内容”