# HTMLAudio

模块 hilo/media/HTMLAudio 依赖 hilo/core/Class, hilo/util/util, hilo/event/EventMixin 源码 HTMLAudio.js
HTMLAudio声音播放模块。此模块使用HTMLAudioElement播放音频。 使用限制：iOS平台需用户事件触发才能播放，很多Android浏览器仅能同时播放一个音频。

### 属性概览

| 属性 | 定义于
--- | --- | ---
| autoPlay:Boolean 是否自动播放。默认为false。 | HTMLAudio
| duration:Number 音频的时长。只读属性。 | HTMLAudio
| loaded:Boolean 音频资源是否已加载完成。只读属性。 | HTMLAudio
| loop:Boolean 是否循环播放。默认为false。 | HTMLAudio
| muted:Boolean 是否静音。默认为false。 | HTMLAudio
| playing:Boolean 是否正在播放音频。只读属性。 | HTMLAudio
| src:String 播放的音频的资源地址。 | HTMLAudio
| volume:Number 音量的大小。取值范围：0-1。 | HTMLAudio
| isSupported static 浏览器是否支持HTMLAudio。 | HTMLAudio

### 方法概览

| 方法 | 定义于
--- | --- | ---
| HTMLAudio(properties:Object) 构造函数 | HTMLAudio
| load() 加载音频文件。 | HTMLAudio
| pause() 暂停音频。 | HTMLAudio
| play() 播放音频。如果正在播放，则会重新开始。 注意：为了避免第一次播放不成功，建议在load音频后再播放。 | HTMLAudio
| resume() 恢复音频播放。 | HTMLAudio
| setMute(muted) 设置静音模式。注意: iOS设备无法设置静音模式。 | HTMLAudio
| setVolume(volume) 设置音量。注意: iOS设备无法设置音量。 | HTMLAudio
| stop() 停止音频播放。 | HTMLAudio

### 属性详情

autoPlay:Boolean
是否自动播放。默认为false。
duration:Number
音频的时长。只读属性。
[Static] isSupported
浏览器是否支持HTMLAudio。
loaded:Boolean
音频资源是否已加载完成。只读属性。
loop:Boolean
是否循环播放。默认为false。
muted:Boolean
是否静音。默认为false。
playing:Boolean
是否正在播放音频。只读属性。
src:String
播放的音频的资源地址。
volume:Number
音量的大小。取值范围：0-1。

### 构造函数

HTMLAudio(properties:Object)

parameters
properties:Object — 创建对象的属性参数。可包含此类所有可写属性。

### 方法详情

load()
加载音频文件。
pause()
暂停音频。
play()
播放音频。如果正在播放，则会重新开始。 注意：为了避免第一次播放不成功，建议在load音频后再播放。
resume()
恢复音频播放。
setMute(muted)
设置静音模式。注意: iOS设备无法设置静音模式。

parameters
muted —

setVolume(volume)
设置音量。注意: iOS设备无法设置音量。

parameters
volume —

stop()
停止音频播放。