音频播放.md 24.9 KB
Newer Older
D
duangavin123 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
# 音频播放<a name="ZH-CN_TOPIC_0000001115974764"></a>

-   [导入模块](#zh-cn_topic_0000001103383404_s56d19203690d4782bfc74069abb6bd71)
-   [权限](#zh-cn_topic_0000001103383404_section11257113618419)
-   [方法](#zh-cn_topic_0000001103383404_section125675489541)
-   [createAudioPlayer\(\)](#zh-cn_topic_0000001103383404_section582314017253)
-   [附录](#zh-cn_topic_0000001103383404_section1933416317165)
-   [AudioPlayer](#zh-cn_topic_0000001103383404_section5174142818365)
    -   [属性](#zh-cn_topic_0000001103383404_section4947115405)
    -   [play\(\)](#zh-cn_topic_0000001103383404_section964512672913)
    -   [pause\(\)](#zh-cn_topic_0000001103383404_section78173258296)
    -   [stop\(\)](#zh-cn_topic_0000001103383404_section122114334296)
    -   [seek\(number\)](#zh-cn_topic_0000001103383404_section1387113816298)
    -   [setVolume\(number\)](#zh-cn_topic_0000001103383404_section164235176552)
    -   [release\(\)](#zh-cn_topic_0000001103383404_section9224621145512)
    -   [事件](#zh-cn_topic_0000001103383404_section5453721192911)
    -   [play](#zh-cn_topic_0000001103383404_section87307411494)
    -   [pause](#zh-cn_topic_0000001103383404_section198217471590)
    -   [stop](#zh-cn_topic_0000001103383404_section437616531910)
    -   [dataLoad](#zh-cn_topic_0000001103383404_section982114219106)
    -   [timeUpdate](#zh-cn_topic_0000001103383404_section13687114181014)
    -   [volumeChange](#zh-cn_topic_0000001103383404_section139227715717)
    -   [finish](#zh-cn_topic_0000001103383404_section15181321181018)
    -   [error](#zh-cn_topic_0000001103383404_section5593132921016)
-   [AudioState](#zh-cn_topic_0000001103383404_section5181155710523)

>![](public_sys-resources/icon-note.gif) **说明:** 
>由于权限问题,此部分功能在标准系统暂不可用,待更新。

## 导入模块<a name="zh-cn_topic_0000001103383404_s56d19203690d4782bfc74069abb6bd71"></a>
M
mamingshuai 已提交
31 32 33 34 35

```
import audio from '@ohos.multimedia.media';
```

D
duangavin123 已提交
36
## 权限<a name="zh-cn_topic_0000001103383404_section11257113618419"></a>
M
mamingshuai 已提交
37 38 39



D
duangavin123 已提交
40
## 方法<a name="zh-cn_topic_0000001103383404_section125675489541"></a>
M
mamingshuai 已提交
41

D
duangavin123 已提交
42
## createAudioPlayer\(\)<a name="zh-cn_topic_0000001103383404_section582314017253"></a>
M
mamingshuai 已提交
43 44 45 46 47

创建音频播放的实例来控制音频的播放。

**返回值:**

D
duangavin123 已提交
48 49
<a name="zh-cn_topic_0000001103383404_table482411406254"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row138241940172518"><th class="cellrowborder" valign="top" width="16.05%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001103383404_p28256407257"><a name="zh-cn_topic_0000001103383404_p28256407257"></a><a name="zh-cn_topic_0000001103383404_p28256407257"></a>类型</p>
M
mamingshuai 已提交
50
</th>
D
duangavin123 已提交
51
<th class="cellrowborder" valign="top" width="83.95%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001103383404_p1582544017256"><a name="zh-cn_topic_0000001103383404_p1582544017256"></a><a name="zh-cn_topic_0000001103383404_p1582544017256"></a>说明</p>
M
mamingshuai 已提交
52 53 54
</th>
</tr>
</thead>
D
duangavin123 已提交
55
<tbody><tr id="zh-cn_topic_0000001103383404_row0825540192520"><td class="cellrowborder" valign="top" width="16.05%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001103383404_p482574042511"><a name="zh-cn_topic_0000001103383404_p482574042511"></a><a name="zh-cn_topic_0000001103383404_p482574042511"></a><a href="#zh-cn_topic_0000001103383404_section5174142818365">AudioPlayer</a></p>
M
mamingshuai 已提交
56
</td>
D
duangavin123 已提交
57
<td class="cellrowborder" valign="top" width="83.95%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001103383404_p14825194014258"><a name="zh-cn_topic_0000001103383404_p14825194014258"></a><a name="zh-cn_topic_0000001103383404_p14825194014258"></a>返回AudioPlayer类实例,失败时返回null。</p>
M
mamingshuai 已提交
58 59 60 61 62 63 64 65 66 67 68
</td>
</tr>
</tbody>
</table>

**示例:**

```
var audioplayer = audio.createAudioPlayer(); 
```

D
duangavin123 已提交
69
## 附录<a name="zh-cn_topic_0000001103383404_section1933416317165"></a>
M
mamingshuai 已提交
70

D
duangavin123 已提交
71
## AudioPlayer<a name="zh-cn_topic_0000001103383404_section5174142818365"></a>
M
mamingshuai 已提交
72 73 74

音频播放器。

D
duangavin123 已提交
75
### 属性<a name="zh-cn_topic_0000001103383404_section4947115405"></a>
M
mamingshuai 已提交
76

D
duangavin123 已提交
77 78
<a name="zh-cn_topic_0000001103383404_table92548495595"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row132541749175917"><th class="cellrowborder" valign="top" width="15.8015801580158%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001103383404_p925404965919"><a name="zh-cn_topic_0000001103383404_p925404965919"></a><a name="zh-cn_topic_0000001103383404_p925404965919"></a>名称</p>
M
mamingshuai 已提交
79
</th>
D
duangavin123 已提交
80
<th class="cellrowborder" valign="top" width="19.591959195919593%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001103383404_p325464914599"><a name="zh-cn_topic_0000001103383404_p325464914599"></a><a name="zh-cn_topic_0000001103383404_p325464914599"></a>参数类型</p>
M
mamingshuai 已提交
81
</th>
D
duangavin123 已提交
82
<th class="cellrowborder" valign="top" width="7.660766076607661%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001103383404_p025484918596"><a name="zh-cn_topic_0000001103383404_p025484918596"></a><a name="zh-cn_topic_0000001103383404_p025484918596"></a>可读</p>
M
mamingshuai 已提交
83
</th>
D
duangavin123 已提交
84
<th class="cellrowborder" valign="top" width="8.29082908290829%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001103383404_p025414499590"><a name="zh-cn_topic_0000001103383404_p025414499590"></a><a name="zh-cn_topic_0000001103383404_p025414499590"></a>可写</p>
M
mamingshuai 已提交
85
</th>
D
duangavin123 已提交
86
<th class="cellrowborder" valign="top" width="48.65486548654865%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001103383404_p20254134925912"><a name="zh-cn_topic_0000001103383404_p20254134925912"></a><a name="zh-cn_topic_0000001103383404_p20254134925912"></a>说明</p>
M
mamingshuai 已提交
87 88 89
</th>
</tr>
</thead>
D
duangavin123 已提交
90
<tbody><tr id="zh-cn_topic_0000001103383404_row18254849155915"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001103383404_p20254204935915"><a name="zh-cn_topic_0000001103383404_p20254204935915"></a><a name="zh-cn_topic_0000001103383404_p20254204935915"></a>src</p>
M
mamingshuai 已提交
91
</td>
D
duangavin123 已提交
92
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001103383404_p1525413497591"><a name="zh-cn_topic_0000001103383404_p1525413497591"></a><a name="zh-cn_topic_0000001103383404_p1525413497591"></a>string</p>
M
mamingshuai 已提交
93
</td>
D
duangavin123 已提交
94
<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001103383404_p8254749195914"><a name="zh-cn_topic_0000001103383404_p8254749195914"></a><a name="zh-cn_topic_0000001103383404_p8254749195914"></a></p>
M
mamingshuai 已提交
95
</td>
D
duangavin123 已提交
96
<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001103383404_p5255549115910"><a name="zh-cn_topic_0000001103383404_p5255549115910"></a><a name="zh-cn_topic_0000001103383404_p5255549115910"></a></p>
M
mamingshuai 已提交
97
</td>
D
duangavin123 已提交
98
<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001103383404_p72551449145914"><a name="zh-cn_topic_0000001103383404_p72551449145914"></a><a name="zh-cn_topic_0000001103383404_p72551449145914"></a>音频媒体URI。</p>
M
mamingshuai 已提交
99 100
</td>
</tr>
D
duangavin123 已提交
101
<tr id="zh-cn_topic_0000001103383404_row10255134945917"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001103383404_p82551349125910"><a name="zh-cn_topic_0000001103383404_p82551349125910"></a><a name="zh-cn_topic_0000001103383404_p82551349125910"></a>loop</p>
M
mamingshuai 已提交
102
</td>
D
duangavin123 已提交
103
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001103383404_p18255154913598"><a name="zh-cn_topic_0000001103383404_p18255154913598"></a><a name="zh-cn_topic_0000001103383404_p18255154913598"></a>boolean</p>
M
mamingshuai 已提交
104
</td>
D
duangavin123 已提交
105
<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001103383404_p525516497595"><a name="zh-cn_topic_0000001103383404_p525516497595"></a><a name="zh-cn_topic_0000001103383404_p525516497595"></a></p>
M
mamingshuai 已提交
106
</td>
D
duangavin123 已提交
107
<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001103383404_p2025504917593"><a name="zh-cn_topic_0000001103383404_p2025504917593"></a><a name="zh-cn_topic_0000001103383404_p2025504917593"></a></p>
M
mamingshuai 已提交
108
</td>
D
duangavin123 已提交
109
<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001103383404_p7255194925919"><a name="zh-cn_topic_0000001103383404_p7255194925919"></a><a name="zh-cn_topic_0000001103383404_p7255194925919"></a>音频循环播放属性。</p>
M
mamingshuai 已提交
110 111
</td>
</tr>
D
duangavin123 已提交
112
<tr id="zh-cn_topic_0000001103383404_row18256049165911"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001103383404_p2256154919590"><a name="zh-cn_topic_0000001103383404_p2256154919590"></a><a name="zh-cn_topic_0000001103383404_p2256154919590"></a>currentTime</p>
M
mamingshuai 已提交
113
</td>
D
duangavin123 已提交
114
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001103383404_p10256849165915"><a name="zh-cn_topic_0000001103383404_p10256849165915"></a><a name="zh-cn_topic_0000001103383404_p10256849165915"></a>number</p>
M
mamingshuai 已提交
115
</td>
D
duangavin123 已提交
116
<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001103383404_p19256149155915"><a name="zh-cn_topic_0000001103383404_p19256149155915"></a><a name="zh-cn_topic_0000001103383404_p19256149155915"></a></p>
M
mamingshuai 已提交
117
</td>
D
duangavin123 已提交
118
<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001103383404_p3256174935919"><a name="zh-cn_topic_0000001103383404_p3256174935919"></a><a name="zh-cn_topic_0000001103383404_p3256174935919"></a></p>
M
mamingshuai 已提交
119
</td>
D
duangavin123 已提交
120
<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001103383404_p12256144995913"><a name="zh-cn_topic_0000001103383404_p12256144995913"></a><a name="zh-cn_topic_0000001103383404_p12256144995913"></a>音频的当前播放阶段。</p>
M
mamingshuai 已提交
121 122
</td>
</tr>
D
duangavin123 已提交
123
<tr id="zh-cn_topic_0000001103383404_row11256144911598"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001103383404_p92561949125910"><a name="zh-cn_topic_0000001103383404_p92561949125910"></a><a name="zh-cn_topic_0000001103383404_p92561949125910"></a>duration</p>
M
mamingshuai 已提交
124
</td>
D
duangavin123 已提交
125
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001103383404_p9256124914597"><a name="zh-cn_topic_0000001103383404_p9256124914597"></a><a name="zh-cn_topic_0000001103383404_p9256124914597"></a>number</p>
M
mamingshuai 已提交
126
</td>
D
duangavin123 已提交
127
<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001103383404_p1725654915911"><a name="zh-cn_topic_0000001103383404_p1725654915911"></a><a name="zh-cn_topic_0000001103383404_p1725654915911"></a></p>
M
mamingshuai 已提交
128
</td>
D
duangavin123 已提交
129
<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001103383404_p192562049125910"><a name="zh-cn_topic_0000001103383404_p192562049125910"></a><a name="zh-cn_topic_0000001103383404_p192562049125910"></a></p>
M
mamingshuai 已提交
130
</td>
D
duangavin123 已提交
131
<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001103383404_p125684995913"><a name="zh-cn_topic_0000001103383404_p125684995913"></a><a name="zh-cn_topic_0000001103383404_p125684995913"></a>音频播放的时长。</p>
M
mamingshuai 已提交
132 133
</td>
</tr>
D
duangavin123 已提交
134
<tr id="zh-cn_topic_0000001103383404_row6256149115920"><td class="cellrowborder" valign="top" width="15.8015801580158%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001103383404_p2256144918596"><a name="zh-cn_topic_0000001103383404_p2256144918596"></a><a name="zh-cn_topic_0000001103383404_p2256144918596"></a>state</p>
M
mamingshuai 已提交
135
</td>
D
duangavin123 已提交
136
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001103383404_p9256144918593"><a name="zh-cn_topic_0000001103383404_p9256144918593"></a><a name="zh-cn_topic_0000001103383404_p9256144918593"></a><a href="#zh-cn_topic_0000001103383404_section5181155710523">AudioState</a></p>
M
mamingshuai 已提交
137
</td>
D
duangavin123 已提交
138
<td class="cellrowborder" valign="top" width="7.660766076607661%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001103383404_p102563495592"><a name="zh-cn_topic_0000001103383404_p102563495592"></a><a name="zh-cn_topic_0000001103383404_p102563495592"></a></p>
M
mamingshuai 已提交
139
</td>
D
duangavin123 已提交
140
<td class="cellrowborder" valign="top" width="8.29082908290829%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001103383404_p625620497594"><a name="zh-cn_topic_0000001103383404_p625620497594"></a><a name="zh-cn_topic_0000001103383404_p625620497594"></a></p>
M
mamingshuai 已提交
141
</td>
D
duangavin123 已提交
142
<td class="cellrowborder" valign="top" width="48.65486548654865%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001103383404_p162571549195920"><a name="zh-cn_topic_0000001103383404_p162571549195920"></a><a name="zh-cn_topic_0000001103383404_p162571549195920"></a>音频播放的状态。</p>
M
mamingshuai 已提交
143 144 145 146 147
</td>
</tr>
</tbody>
</table>

D
duangavin123 已提交
148
### play\(\)<a name="zh-cn_topic_0000001103383404_section964512672913"></a>
M
mamingshuai 已提交
149 150 151 152 153 154

开始播放音频资源。

**示例:**

```
D
duangavin123 已提交
155
audioplayer.src = 'common/mydream.mp3';
M
mamingshuai 已提交
156 157
audioplayer.on('play', (err, action) => {
  if (err) {
D
duangavin123 已提交
158
     console.log(`err returned in play() callback`);
M
mamingshuai 已提交
159 160
     return;
  }
D
duangavin123 已提交
161 162
  console.log('start to play');
  audioplayer.pause();
M
mamingshuai 已提交
163
};
D
duangavin123 已提交
164
audioplayer.play();
M
mamingshuai 已提交
165 166
```

D
duangavin123 已提交
167
### pause\(\)<a name="zh-cn_topic_0000001103383404_section78173258296"></a>
M
mamingshuai 已提交
168 169 170 171 172 173

暂停播放音频资源。

**示例:**

```
D
duangavin123 已提交
174
audioplayer.src = 'common/mydream.mp3';
M
mamingshuai 已提交
175 176
audioplayer.on('pause', (err, action) => {
  if (err) {
D
duangavin123 已提交
177
     console.log(`err returned in pause() callback`);
M
mamingshuai 已提交
178 179
     return;
  }
D
duangavin123 已提交
180
  console.log('playback pause');
M
mamingshuai 已提交
181
};
D
duangavin123 已提交
182
audioplayer.pause();
M
mamingshuai 已提交
183 184
```

D
duangavin123 已提交
185
### stop\(\)<a name="zh-cn_topic_0000001103383404_section122114334296"></a>
M
mamingshuai 已提交
186 187 188 189 190 191

停止播放音频资源。

**示例:**

```
D
duangavin123 已提交
192 193
audioplayer.src = 'common/mydream.mp3';
audioplayer.on('stop',(err, action) => {
Z
zengyawen 已提交
194
  if (err) {
D
duangavin123 已提交
195
     console.log(`err returned in stop() callback`);
Z
zengyawen 已提交
196 197
     return;
  }
D
duangavin123 已提交
198
  console.log('playback stop');
Z
zengyawen 已提交
199
};
D
duangavin123 已提交
200
audioplayer.stop();
M
mamingshuai 已提交
201 202
```

D
duangavin123 已提交
203
### seek\(number\)<a name="zh-cn_topic_0000001103383404_section1387113816298"></a>
M
mamingshuai 已提交
204 205 206 207 208

跳转到指定播放位置。

**参数:**

D
duangavin123 已提交
209 210
<a name="zh-cn_topic_0000001103383404_table1442723852917"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row84261138172911"><th class="cellrowborder" valign="top" width="17.57%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001103383404_p204261938182919"><a name="zh-cn_topic_0000001103383404_p204261938182919"></a><a name="zh-cn_topic_0000001103383404_p204261938182919"></a>参数名</p>
M
mamingshuai 已提交
211
</th>
D
duangavin123 已提交
212
<th class="cellrowborder" valign="top" width="12.02%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001103383404_p1342683842920"><a name="zh-cn_topic_0000001103383404_p1342683842920"></a><a name="zh-cn_topic_0000001103383404_p1342683842920"></a>类型</p>
M
mamingshuai 已提交
213
</th>
D
duangavin123 已提交
214
<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001103383404_p134260383297"><a name="zh-cn_topic_0000001103383404_p134260383297"></a><a name="zh-cn_topic_0000001103383404_p134260383297"></a>必填</p>
M
mamingshuai 已提交
215
</th>
D
duangavin123 已提交
216
<th class="cellrowborder" valign="top" width="62.89%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001103383404_p442663832912"><a name="zh-cn_topic_0000001103383404_p442663832912"></a><a name="zh-cn_topic_0000001103383404_p442663832912"></a>说明</p>
M
mamingshuai 已提交
217 218 219
</th>
</tr>
</thead>
D
duangavin123 已提交
220
<tbody><tr id="zh-cn_topic_0000001103383404_row18427738202910"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p184261338192913"><a name="zh-cn_topic_0000001103383404_p184261338192913"></a><a name="zh-cn_topic_0000001103383404_p184261338192913"></a>timeMs</p>
M
mamingshuai 已提交
221
</td>
D
duangavin123 已提交
222
<td class="cellrowborder" valign="top" width="12.02%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p1242643819295"><a name="zh-cn_topic_0000001103383404_p1242643819295"></a><a name="zh-cn_topic_0000001103383404_p1242643819295"></a>number</p>
M
mamingshuai 已提交
223
</td>
D
duangavin123 已提交
224
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p44261838112918"><a name="zh-cn_topic_0000001103383404_p44261838112918"></a><a name="zh-cn_topic_0000001103383404_p44261838112918"></a></p>
M
mamingshuai 已提交
225
</td>
D
duangavin123 已提交
226
<td class="cellrowborder" valign="top" width="62.89%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p16427163812913"><a name="zh-cn_topic_0000001103383404_p16427163812913"></a><a name="zh-cn_topic_0000001103383404_p16427163812913"></a>想要跳转到的时间点。</p>
M
mamingshuai 已提交
227 228 229 230 231 232 233 234
</td>
</tr>
</tbody>
</table>

**示例:**

```
D
duangavin123 已提交
235 236
audioplayer.src = 'common/mydream.mp3';
audioplayer.on('timeupdate', (err, action) => {
Z
zengyawen 已提交
237
  if (err) {
D
duangavin123 已提交
238
     console.log(`err returned in seek() callback`);
Z
zengyawen 已提交
239 240
     return;
  }
M
mamingshuai 已提交
241
  var newTime = audioplayer.currenTime;
D
duangavin123 已提交
242 243
  if(newTime = 30000) {
    console.info('Seek success, new time : ' + newTime);
M
mamingshuai 已提交
244
  } else {
D
duangavin123 已提交
245
    console.info('Seek Failed');
M
mamingshuai 已提交
246 247 248 249 250
  }
};
audioplayer.seek(30000);
```

D
duangavin123 已提交
251
### setVolume\(number\)<a name="zh-cn_topic_0000001103383404_section164235176552"></a>
M
mamingshuai 已提交
252 253 254 255 256

设置音量。

**参数:**

D
duangavin123 已提交
257 258
<a name="zh-cn_topic_0000001103383404_table1242391713555"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row14424217195517"><th class="cellrowborder" valign="top" width="17.57%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001103383404_p1424917135519"><a name="zh-cn_topic_0000001103383404_p1424917135519"></a><a name="zh-cn_topic_0000001103383404_p1424917135519"></a>参数名</p>
M
mamingshuai 已提交
259
</th>
D
duangavin123 已提交
260
<th class="cellrowborder" valign="top" width="12.02%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001103383404_p10424121795520"><a name="zh-cn_topic_0000001103383404_p10424121795520"></a><a name="zh-cn_topic_0000001103383404_p10424121795520"></a>类型</p>
M
mamingshuai 已提交
261
</th>
D
duangavin123 已提交
262
<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001103383404_p1042415178559"><a name="zh-cn_topic_0000001103383404_p1042415178559"></a><a name="zh-cn_topic_0000001103383404_p1042415178559"></a>必填</p>
M
mamingshuai 已提交
263
</th>
D
duangavin123 已提交
264
<th class="cellrowborder" valign="top" width="62.89%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001103383404_p13424717125513"><a name="zh-cn_topic_0000001103383404_p13424717125513"></a><a name="zh-cn_topic_0000001103383404_p13424717125513"></a>说明</p>
M
mamingshuai 已提交
265 266 267
</th>
</tr>
</thead>
D
duangavin123 已提交
268
<tbody><tr id="zh-cn_topic_0000001103383404_row13424171745513"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p204241517125517"><a name="zh-cn_topic_0000001103383404_p204241517125517"></a><a name="zh-cn_topic_0000001103383404_p204241517125517"></a>vol</p>
M
mamingshuai 已提交
269
</td>
D
duangavin123 已提交
270
<td class="cellrowborder" valign="top" width="12.02%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p18424121755517"><a name="zh-cn_topic_0000001103383404_p18424121755517"></a><a name="zh-cn_topic_0000001103383404_p18424121755517"></a>number</p>
M
mamingshuai 已提交
271
</td>
D
duangavin123 已提交
272
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p2042417176554"><a name="zh-cn_topic_0000001103383404_p2042417176554"></a><a name="zh-cn_topic_0000001103383404_p2042417176554"></a></p>
M
mamingshuai 已提交
273
</td>
D
duangavin123 已提交
274
<td class="cellrowborder" valign="top" width="62.89%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p9424171717557"><a name="zh-cn_topic_0000001103383404_p9424171717557"></a><a name="zh-cn_topic_0000001103383404_p9424171717557"></a>想要设置的音量值。</p>
M
mamingshuai 已提交
275 276 277 278 279 280 281 282
</td>
</tr>
</tbody>
</table>

**示例:**

```
Z
zengyawen 已提交
283
audioplayer.src = 'common/mydream.mp3';
D
duangavin123 已提交
284
audioplayer.on('volumeChange', (err, action) => {
Z
zengyawen 已提交
285
  if (err) {
D
duangavin123 已提交
286
     console.log(`err returned in setVolume() callback`);
Z
zengyawen 已提交
287 288
     return;
  }
D
duangavin123 已提交
289
  console.log('playback volume change');
Z
zengyawen 已提交
290
};
D
duangavin123 已提交
291
audioplayer.setVolume(30);
M
mamingshuai 已提交
292 293
```

D
duangavin123 已提交
294
### release\(\)<a name="zh-cn_topic_0000001103383404_section9224621145512"></a>
M
mamingshuai 已提交
295 296 297 298 299 300 301 302 303

释放音频资源。

**示例:**

```
audioplay.release();
```

D
duangavin123 已提交
304
### 事件<a name="zh-cn_topic_0000001103383404_section5453721192911"></a>
M
mamingshuai 已提交
305

D
duangavin123 已提交
306
### play<a name="zh-cn_topic_0000001103383404_section87307411494"></a>
M
mamingshuai 已提交
307 308 309

在调用play方法后的回调事件。

D
duangavin123 已提交
310
### pause<a name="zh-cn_topic_0000001103383404_section198217471590"></a>
M
mamingshuai 已提交
311 312 313

在调用pause方法后的回调事件。

D
duangavin123 已提交
314
### stop<a name="zh-cn_topic_0000001103383404_section437616531910"></a>
M
mamingshuai 已提交
315 316 317

在调用stop方法后的回调事件。

D
duangavin123 已提交
318
### dataLoad<a name="zh-cn_topic_0000001103383404_section982114219106"></a>
M
mamingshuai 已提交
319 320 321

在音频数据加载后的回调事件。

D
duangavin123 已提交
322
### timeUpdate<a name="zh-cn_topic_0000001103383404_section13687114181014"></a>
M
mamingshuai 已提交
323 324 325

在播放时间改变后的回调事件。

D
duangavin123 已提交
326
### volumeChange<a name="zh-cn_topic_0000001103383404_section139227715717"></a>
M
mamingshuai 已提交
327 328 329

在播放音量改变后的回调事件。

D
duangavin123 已提交
330
### finish<a name="zh-cn_topic_0000001103383404_section15181321181018"></a>
M
mamingshuai 已提交
331 332 333

在播放完成后的回调事件。

D
duangavin123 已提交
334
### error<a name="zh-cn_topic_0000001103383404_section5593132921016"></a>
M
mamingshuai 已提交
335 336 337

在播放错误时的回调事件。

D
duangavin123 已提交
338 339
<a name="zh-cn_topic_0000001103383404_table24591722143619"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row1945962219364"><th class="cellrowborder" valign="top" width="24.060000000000002%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001103383404_p84591522103610"><a name="zh-cn_topic_0000001103383404_p84591522103610"></a><a name="zh-cn_topic_0000001103383404_p84591522103610"></a>参数名</p>
M
mamingshuai 已提交
340
</th>
D
duangavin123 已提交
341
<th class="cellrowborder" valign="top" width="25.25%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001103383404_p11459102243616"><a name="zh-cn_topic_0000001103383404_p11459102243616"></a><a name="zh-cn_topic_0000001103383404_p11459102243616"></a>类型</p>
M
mamingshuai 已提交
342
</th>
D
duangavin123 已提交
343
<th class="cellrowborder" valign="top" width="50.690000000000005%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001103383404_p14591922113616"><a name="zh-cn_topic_0000001103383404_p14591922113616"></a><a name="zh-cn_topic_0000001103383404_p14591922113616"></a>说明</p>
M
mamingshuai 已提交
344 345 346
</th>
</tr>
</thead>
D
duangavin123 已提交
347
<tbody><tr id="zh-cn_topic_0000001103383404_row2459622183611"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p17338122234119"><a name="zh-cn_topic_0000001103383404_p17338122234119"></a><a name="zh-cn_topic_0000001103383404_p17338122234119"></a>callback</p>
M
mamingshuai 已提交
348
</td>
D
duangavin123 已提交
349
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p174601822193612"><a name="zh-cn_topic_0000001103383404_p174601822193612"></a><a name="zh-cn_topic_0000001103383404_p174601822193612"></a>ErrorCallback</p>
M
mamingshuai 已提交
350
</td>
D
duangavin123 已提交
351
<td class="cellrowborder" valign="top" width="50.690000000000005%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p7460222123612"><a name="zh-cn_topic_0000001103383404_p7460222123612"></a><a name="zh-cn_topic_0000001103383404_p7460222123612"></a>错误事件的回调函数。</p>
M
mamingshuai 已提交
352 353 354 355 356
</td>
</tr>
</tbody>
</table>

D
duangavin123 已提交
357
## AudioState<a name="zh-cn_topic_0000001103383404_section5181155710523"></a>
M
mamingshuai 已提交
358 359 360

音频播放的状态机。

D
duangavin123 已提交
361 362
<a name="zh-cn_topic_0000001103383404_table919114616314"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row31917610318"><th class="cellrowborder" valign="top" width="33.739999999999995%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001103383404_p219196531"><a name="zh-cn_topic_0000001103383404_p219196531"></a><a name="zh-cn_topic_0000001103383404_p219196531"></a>名称</p>
M
mamingshuai 已提交
363
</th>
D
duangavin123 已提交
364
<th class="cellrowborder" valign="top" width="66.25999999999999%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001103383404_p14191563313"><a name="zh-cn_topic_0000001103383404_p14191563313"></a><a name="zh-cn_topic_0000001103383404_p14191563313"></a>描述</p>
M
mamingshuai 已提交
365 366 367
</th>
</tr>
</thead>
D
duangavin123 已提交
368
<tbody><tr id="zh-cn_topic_0000001103383404_row2019146539"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001103383404_p201913617311"><a name="zh-cn_topic_0000001103383404_p201913617311"></a><a name="zh-cn_topic_0000001103383404_p201913617311"></a>playing</p>
M
mamingshuai 已提交
369
</td>
D
duangavin123 已提交
370
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001103383404_p81911362316"><a name="zh-cn_topic_0000001103383404_p81911362316"></a><a name="zh-cn_topic_0000001103383404_p81911362316"></a>音频正在播放。</p>
M
mamingshuai 已提交
371 372
</td>
</tr>
D
duangavin123 已提交
373
<tr id="zh-cn_topic_0000001103383404_row11912612316"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001103383404_p9191136731"><a name="zh-cn_topic_0000001103383404_p9191136731"></a><a name="zh-cn_topic_0000001103383404_p9191136731"></a>paused</p>
M
mamingshuai 已提交
374
</td>
D
duangavin123 已提交
375
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001103383404_p419166738"><a name="zh-cn_topic_0000001103383404_p419166738"></a><a name="zh-cn_topic_0000001103383404_p419166738"></a>音频暂停播放<span></span></p>
M
mamingshuai 已提交
376 377
</td>
</tr>
D
duangavin123 已提交
378
<tr id="zh-cn_topic_0000001103383404_row111912617314"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001103383404_p9191156333"><a name="zh-cn_topic_0000001103383404_p9191156333"></a><a name="zh-cn_topic_0000001103383404_p9191156333"></a>stopped</p>
M
mamingshuai 已提交
379
</td>
D
duangavin123 已提交
380
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001103383404_p2019215618316"><a name="zh-cn_topic_0000001103383404_p2019215618316"></a><a name="zh-cn_topic_0000001103383404_p2019215618316"></a>音频播放停止。</p>
M
mamingshuai 已提交
381 382 383 384 385
</td>
</tr>
</tbody>
</table>