1# 音频播放<a name="ZH-CN_TOPIC_0000001164295590"></a> 2 3## 导入模块<a name="zh-cn_topic_0000001103383404_s56d19203690d4782bfc74069abb6bd71"></a> 4 5``` 6import media from '@ohos.multimedia.media'; 7``` 8 9## 权限<a name="zh-cn_topic_0000001103383404_section11257113618419"></a> 10 11无 12 13## createAudioPlayer\(\)<a name="zh-cn_topic_0000001103383404_section582314017253"></a> 14 15创建音频播放的实例。 16 17- 参数： 18 19 无 20 21- 返回值： 22 23<a name="zh-cn_topic_0000001103383404_table482411406254"></a> 24<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> 25</th> 26<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> 27</th> 28</tr> 29</thead> 30<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> 31</td> 32<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> 33</td> 34</tr> 35</tbody> 36</table> 37 38**示例：** 39 40``` 41var audioplayer = media.createAudioPlayer(); 42``` 43 44## AudioPlayer<a name="zh-cn_topic_0000001103383404_section5174142818365"></a> 45 46音频播放管理类，用于管理和播放音频媒体。在调用AudioPlayer的方法前，需要先通过[createAudioPlayer\(\)](#zh-cn_topic_0000001103383404_section582314017253)构建一个AudioPlayer实例。 47 48### 属性<a name="zh-cn_topic_0000001103383404_section4947115405"></a> 49 50<a name="zh-cn_topic_0000001103383404_table92548495595"></a> 51<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> 52</th> 53<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> 54</th> 55<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> 56</th> 57<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> 58</th> 59<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> 60</th> 61</tr> 62</thead> 63<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> 64</td> 65<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> 66</td> 67<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> 68</td> 69<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> 70</td> 71<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，支持当前主流的音频格式(mp4、aac、mp3、ogg)，支持本地绝对路径（file://)</p> 72</td> 73</tr> 74<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> 75</td> 76<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> 77</td> 78<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> 79</td> 80<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> 81</td> 82<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>音频循环播放属性，设置为'true'表示循环播放。</p> 83</td> 84</tr> 85<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> 86</td> 87<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> 88</td> 89<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> 90</td> 91<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> 92</td> 93<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> 94</td> 95</tr> 96<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> 97</td> 98<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> 99</td> 100<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> 101</td> 102<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> 103</td> 104<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> 105</td> 106</tr> 107<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> 108</td> 109<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> 110</td> 111<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> 112</td> 113<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> 114</td> 115<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> 116</td> 117</tr> 118</tbody> 119</table> 120 121### play\(\): void<a name="zh-cn_topic_0000001103383404_section964512672913"></a> 122 123开始播放音频资源。 124 125- 参数： 126 127 无 128 129- 返回值： 130 131 无 132 133- 示例： 134 135 ``` 136 audioplayer.src = 'file:///data/media/sounds.mp4'; 137 audioplayer.on('play', () => { 138 console.log('Playback starts.'); 139 }); 140 audioplayer.play(); 141 ``` 142 143 144### pause\(\): void<a name="zh-cn_topic_0000001103383404_section78173258296"></a> 145 146暂停播放音频资源。 147 148- 参数： 149 150 无 151 152- 返回值： 153 154 无 155 156- 示例： 157 158 ``` 159 audioplayer.src = 'file:///data/media/sounds.mp4'; 160 audioplayer.on('pause', () => { 161 console.log('Playback paused.'); 162 }); 163 audioplayer.pause(); 164 ``` 165 166 167### stop\(\): void<a name="zh-cn_topic_0000001103383404_section122114334296"></a> 168 169停止播放音频资源。 170 171- 参数： 172 173 无 174 175- 返回值： 176 177 无 178 179- 示例： 180 181 ``` 182 audioplayer.src = 'file:///data/media/sounds.mp4'; 183 audioplayer.on('stop',() => { 184 console.log('Playback stopped.'); 185 }); 186 audioplayer.stop(); 187 ``` 188 189 190### seek\(timeMs: number\): void<a name="zh-cn_topic_0000001103383404_section1387113816298"></a> 191 192跳转到指定播放位置。 193 194- 参数： 195 196 <a name="zh-cn_topic_0000001103383404_table1442723852917"></a> 197 <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> 198 </th> 199 <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> 200 </th> 201 <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> 202 </th> 203 <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> 204 </th> 205 </tr> 206 </thead> 207 <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> 208 </td> 209 <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> 210 </td> 211 <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> 212 </td> 213 <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> 214 </td> 215 </tr> 216 </tbody> 217 </table> 218 219- 返回值： 220 221 无 222 223- 示例： 224 225 ``` 226 audioplayer.src = 'file:///data/media/sounds.mp4'; 227 audioplayer.on('timeupdate', (action) => { 228 var newTime = audioplayer.currenTime; 229 if(newTime >= 30000) { 230 console.info('Seek succeeded. New time: ' + newTime); 231 } else { 232 console.info('Seek failed.'); 233 } 234 }); 235 audioplayer.seek(30000); 236 ``` 237 238 239### setVolume\(vol: number\): void<a name="zh-cn_topic_0000001103383404_section164235176552"></a> 240 241设置音量。 242 243- 参数： 244 245 <a name="zh-cn_topic_0000001103383404_table1242391713555"></a> 246 <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> 247 </th> 248 <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> 249 </th> 250 <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> 251 </th> 252 <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> 253 </th> 254 </tr> 255 </thead> 256 <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> 257 </td> 258 <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> 259 </td> 260 <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> 261 </td> 262 <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>指定的相对音量大小，取值范围为[0.00-1.00]，1表示最大音量，即100%。</p> 263 </td> 264 </tr> 265 </tbody> 266 </table> 267 268- 返回值： 269 270 无 271 272- 示例： 273 274 ``` 275 audioplayer.src = 'file:///data/media/sounds.mp4'; 276 audioplayer.on('volumeChange', () => { 277 console.log('Playback volume changed.'); 278 }); 279 audioplayer.setVolume(1); 280 ``` 281 282 283### reset\(\): void<sup>7+</sup><a name="zh-cn_topic_0000001103383404_section1473283011356"></a> 284 285切换播放音频资源。 286 287- 参数： 288 289 无 290 291- 返回值： 292 293 无 294 295- 示例： 296 297 ``` 298 audioplay.reset(); 299 ``` 300 301 302### release\(\): void<a name="zh-cn_topic_0000001103383404_section9224621145512"></a> 303 304释放音频资源。 305 306- 参数： 307 308 无 309 310- 返回值： 311 312 无 313 314- 示例： 315 316``` 317audioplay.release(); 318``` 319 320### on\(type: string, callback: \(\) =\> void\): void<a name="zh-cn_topic_0000001103383404_section4486193914193"></a> 321 322开始监听音频播放事件。 323 324- 参数： 325 326 <a name="zh-cn_topic_0000001103383404_table173988426207"></a> 327 <table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row15398042162016"><th class="cellrowborder" valign="top" width="13.239999999999998%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001103383404_p8398114217208"><a name="zh-cn_topic_0000001103383404_p8398114217208"></a><a name="zh-cn_topic_0000001103383404_p8398114217208"></a>参数名</p> 328 </th> 329 <th class="cellrowborder" valign="top" width="24.36%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001103383404_p18398184232010"><a name="zh-cn_topic_0000001103383404_p18398184232010"></a><a name="zh-cn_topic_0000001103383404_p18398184232010"></a>类型</p> 330 </th> 331 <th class="cellrowborder" valign="top" width="8.110000000000001%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001103383404_p1839884211207"><a name="zh-cn_topic_0000001103383404_p1839884211207"></a><a name="zh-cn_topic_0000001103383404_p1839884211207"></a>必填</p> 332 </th> 333 <th class="cellrowborder" valign="top" width="54.290000000000006%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001103383404_p12399164214204"><a name="zh-cn_topic_0000001103383404_p12399164214204"></a><a name="zh-cn_topic_0000001103383404_p12399164214204"></a>说明</p> 334 </th> 335 </tr> 336 </thead> 337 <tbody><tr id="zh-cn_topic_0000001103383404_row12399042112010"><td class="cellrowborder" valign="top" width="13.239999999999998%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p2399104292011"><a name="zh-cn_topic_0000001103383404_p2399104292011"></a><a name="zh-cn_topic_0000001103383404_p2399104292011"></a>type</p> 338 </td> 339 <td class="cellrowborder" valign="top" width="24.36%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p7399194217203"><a name="zh-cn_topic_0000001103383404_p7399194217203"></a><a name="zh-cn_topic_0000001103383404_p7399194217203"></a>string</p> 340 </td> 341 <td class="cellrowborder" valign="top" width="8.110000000000001%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p23991942102016"><a name="zh-cn_topic_0000001103383404_p23991942102016"></a><a name="zh-cn_topic_0000001103383404_p23991942102016"></a>是</p> 342 </td> 343 <td class="cellrowborder" valign="top" width="54.290000000000006%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p153991742142013"><a name="zh-cn_topic_0000001103383404_p153991742142013"></a><a name="zh-cn_topic_0000001103383404_p153991742142013"></a>播放事件回调类型，支持的<a href="#zh-cn_topic_0000001103383404_section1825183472812">事件</a>包括：'play' | 'pause' | 'stop' | 'dataLoad' |'reset'| |'finish' | 'volumeChange'。</p> 344 </td> 345 </tr> 346 <tr id="zh-cn_topic_0000001103383404_row12630221183811"><td class="cellrowborder" valign="top" width="13.239999999999998%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p9630192123817"><a name="zh-cn_topic_0000001103383404_p9630192123817"></a><a name="zh-cn_topic_0000001103383404_p9630192123817"></a>callback</p> 347 </td> 348 <td class="cellrowborder" valign="top" width="24.36%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p289624913915"><a name="zh-cn_topic_0000001103383404_p289624913915"></a><a name="zh-cn_topic_0000001103383404_p289624913915"></a>()=>void</p> 349 </td> 350 <td class="cellrowborder" valign="top" width="8.110000000000001%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p14630121163820"><a name="zh-cn_topic_0000001103383404_p14630121163820"></a><a name="zh-cn_topic_0000001103383404_p14630121163820"></a>是</p> 351 </td> 352 <td class="cellrowborder" valign="top" width="54.290000000000006%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p662492335319"><a name="zh-cn_topic_0000001103383404_p662492335319"></a><a name="zh-cn_topic_0000001103383404_p662492335319"></a>播放事件回调方法。</p> 353 </td> 354 </tr> 355 </tbody> 356 </table> 357 358- 返回值： 359 360 无 361 362- 示例： 363 364 ``` 365 audioplayer.src = 'file://xxx/sounds.mp4'; 366 audioplayer.on('play', () => { 367 console.log('Playback starts.'); 368 }); 369 audioplayer.play(); 370 ``` 371 372 373### on\(type: string, callback: Callback<number\>\): void<a name="zh-cn_topic_0000001103383404_section632591014157"></a> 374 375开始监听音频播放时间戳更新事件。 376 377- 参数： 378 379 <a name="zh-cn_topic_0000001103383404_table15325191001518"></a> 380 <table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row73258108159"><th class="cellrowborder" valign="top" width="13.239999999999998%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001103383404_p103252103151"><a name="zh-cn_topic_0000001103383404_p103252103151"></a><a name="zh-cn_topic_0000001103383404_p103252103151"></a>参数名</p> 381 </th> 382 <th class="cellrowborder" valign="top" width="24.36%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001103383404_p1432581081519"><a name="zh-cn_topic_0000001103383404_p1432581081519"></a><a name="zh-cn_topic_0000001103383404_p1432581081519"></a>类型</p> 383 </th> 384 <th class="cellrowborder" valign="top" width="8.110000000000001%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001103383404_p63261110171516"><a name="zh-cn_topic_0000001103383404_p63261110171516"></a><a name="zh-cn_topic_0000001103383404_p63261110171516"></a>必填</p> 385 </th> 386 <th class="cellrowborder" valign="top" width="54.290000000000006%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001103383404_p1032611105153"><a name="zh-cn_topic_0000001103383404_p1032611105153"></a><a name="zh-cn_topic_0000001103383404_p1032611105153"></a>说明</p> 387 </th> 388 </tr> 389 </thead> 390 <tbody><tr id="zh-cn_topic_0000001103383404_row16326410151518"><td class="cellrowborder" valign="top" width="13.239999999999998%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p183262010121514"><a name="zh-cn_topic_0000001103383404_p183262010121514"></a><a name="zh-cn_topic_0000001103383404_p183262010121514"></a>type</p> 391 </td> 392 <td class="cellrowborder" valign="top" width="24.36%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p17326151020154"><a name="zh-cn_topic_0000001103383404_p17326151020154"></a><a name="zh-cn_topic_0000001103383404_p17326151020154"></a>string</p> 393 </td> 394 <td class="cellrowborder" valign="top" width="8.110000000000001%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p203261107150"><a name="zh-cn_topic_0000001103383404_p203261107150"></a><a name="zh-cn_topic_0000001103383404_p203261107150"></a>是</p> 395 </td> 396 <td class="cellrowborder" valign="top" width="54.290000000000006%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p13261510131520"><a name="zh-cn_topic_0000001103383404_p13261510131520"></a><a name="zh-cn_topic_0000001103383404_p13261510131520"></a>播放事件回调类型，支持的<a href="#zh-cn_topic_0000001103383404_section1825183472812">事件</a>为：'timeUpdate'。</p> 397 </td> 398 </tr> 399 <tr id="zh-cn_topic_0000001103383404_row0326161061519"><td class="cellrowborder" valign="top" width="13.239999999999998%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p132601016153"><a name="zh-cn_topic_0000001103383404_p132601016153"></a><a name="zh-cn_topic_0000001103383404_p132601016153"></a>callback</p> 400 </td> 401 <td class="cellrowborder" valign="top" width="24.36%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p5431133013534"><a name="zh-cn_topic_0000001103383404_p5431133013534"></a><a name="zh-cn_topic_0000001103383404_p5431133013534"></a>Callback<number></p> 402 </td> 403 <td class="cellrowborder" valign="top" width="8.110000000000001%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p123261510191514"><a name="zh-cn_topic_0000001103383404_p123261510191514"></a><a name="zh-cn_topic_0000001103383404_p123261510191514"></a>是</p> 404 </td> 405 <td class="cellrowborder" valign="top" width="54.290000000000006%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p20326141021519"><a name="zh-cn_topic_0000001103383404_p20326141021519"></a><a name="zh-cn_topic_0000001103383404_p20326141021519"></a>播放事件回调方法。</p> 406 </td> 407 </tr> 408 </tbody> 409 </table> 410 411- 返回值： 412 413 无 414 415- 示例： 416 417 ``` 418 audioplayer.src = 'file://xxx/sounds.mp4'; 419 audioplayer.on('timeupdate', (newTime ) => { 420 if(newTime >= 30000) { 421 console.info('Seek succeeded. New time: ' + newTime); 422 } else { 423 console.info('Seek failed.'); 424 } 425 }); 426 audioplayer.seek(30000); 427 ``` 428 429 430### on\(type: string, callback: ErrorCallback\): void<a name="zh-cn_topic_0000001103383404_section92241852949"></a> 431 432开始监听音频播放错误事件。 433 434- 参数： 435 436 <a name="zh-cn_topic_0000001103383404_table022416523419"></a> 437 <table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row112256529412"><th class="cellrowborder" valign="top" width="17.57%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001103383404_p0225752844"><a name="zh-cn_topic_0000001103383404_p0225752844"></a><a name="zh-cn_topic_0000001103383404_p0225752844"></a>参数名</p> 438 </th> 439 <th class="cellrowborder" valign="top" width="19.8%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001103383404_p52258520419"><a name="zh-cn_topic_0000001103383404_p52258520419"></a><a name="zh-cn_topic_0000001103383404_p52258520419"></a>类型</p> 440 </th> 441 <th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001103383404_p1622511526412"><a name="zh-cn_topic_0000001103383404_p1622511526412"></a><a name="zh-cn_topic_0000001103383404_p1622511526412"></a>必填</p> 442 </th> 443 <th class="cellrowborder" valign="top" width="51.959999999999994%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001103383404_p6225125211417"><a name="zh-cn_topic_0000001103383404_p6225125211417"></a><a name="zh-cn_topic_0000001103383404_p6225125211417"></a>说明</p> 444 </th> 445 </tr> 446 </thead> 447 <tbody><tr id="zh-cn_topic_0000001103383404_row2225752043"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p0225152949"><a name="zh-cn_topic_0000001103383404_p0225152949"></a><a name="zh-cn_topic_0000001103383404_p0225152949"></a>type</p> 448 </td> 449 <td class="cellrowborder" valign="top" width="19.8%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p722565219414"><a name="zh-cn_topic_0000001103383404_p722565219414"></a><a name="zh-cn_topic_0000001103383404_p722565219414"></a>string</p> 450 </td> 451 <td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p122545216416"><a name="zh-cn_topic_0000001103383404_p122545216416"></a><a name="zh-cn_topic_0000001103383404_p122545216416"></a>是</p> 452 </td> 453 <td class="cellrowborder" valign="top" width="51.959999999999994%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p5225185217419"><a name="zh-cn_topic_0000001103383404_p5225185217419"></a><a name="zh-cn_topic_0000001103383404_p5225185217419"></a>播放错误事件回调类型'error'。</p> 454 </td> 455 </tr> 456 <tr id="zh-cn_topic_0000001103383404_row142257521545"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001103383404_p922565214419"><a name="zh-cn_topic_0000001103383404_p922565214419"></a><a name="zh-cn_topic_0000001103383404_p922565214419"></a>callback</p> 457 </td> 458 <td class="cellrowborder" valign="top" width="19.8%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001103383404_p349810515716"><a name="zh-cn_topic_0000001103383404_p349810515716"></a><a name="zh-cn_topic_0000001103383404_p349810515716"></a>ErrorCallback</p> 459 </td> 460 <td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001103383404_p022510528410"><a name="zh-cn_topic_0000001103383404_p022510528410"></a><a name="zh-cn_topic_0000001103383404_p022510528410"></a>是</p> 461 </td> 462 <td class="cellrowborder" valign="top" width="51.959999999999994%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001103383404_p72251052344"><a name="zh-cn_topic_0000001103383404_p72251052344"></a><a name="zh-cn_topic_0000001103383404_p72251052344"></a>播放错误事件回调方法。</p> 463 </td> 464 </tr> 465 </tbody> 466 </table> 467 468- 返回值： 469 470 无 471 472- 示例： 473 474 ``` 475 audioplayer.src = 'file:///data/sounds.mp4'; 476 audioplayer.on('error', (err) => { 477 console.info('error callback info: ' + err); 478 }); 479 audioplayer.setVolume(30000); 480 ``` 481 482 483### 事件<a name="zh-cn_topic_0000001103383404_section1825183472812"></a> 484 485AudioPlayer支持订阅以下事件。 486 487<a name="zh-cn_topic_0000001103383404_table169181418553"></a> 488<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row26924142558"><th class="cellrowborder" valign="top" width="21.542154215421544%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001103383404_p2069220147551"><a name="zh-cn_topic_0000001103383404_p2069220147551"></a><a name="zh-cn_topic_0000001103383404_p2069220147551"></a>名称</p> 489</th> 490<th class="cellrowborder" valign="top" width="21.992199219921993%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001103383404_p12692191417558"><a name="zh-cn_topic_0000001103383404_p12692191417558"></a><a name="zh-cn_topic_0000001103383404_p12692191417558"></a>参数</p> 491</th> 492<th class="cellrowborder" valign="top" width="56.46564656465647%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001103383404_p8692121445517"><a name="zh-cn_topic_0000001103383404_p8692121445517"></a><a name="zh-cn_topic_0000001103383404_p8692121445517"></a>描述</p> 493</th> 494</tr> 495</thead> 496<tbody><tr id="zh-cn_topic_0000001103383404_row10692171415556"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p176920145554"><a name="zh-cn_topic_0000001103383404_p176920145554"></a><a name="zh-cn_topic_0000001103383404_p176920145554"></a>play</p> 497</td> 498<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p169215148554"><a name="zh-cn_topic_0000001103383404_p169215148554"></a><a name="zh-cn_topic_0000001103383404_p169215148554"></a>-</p> 499</td> 500<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p176921014135520"><a name="zh-cn_topic_0000001103383404_p176921014135520"></a><a name="zh-cn_topic_0000001103383404_p176921014135520"></a>完成play方法调用，音频开始播放，触发该事件。</p> 501</td> 502</tr> 503<tr id="zh-cn_topic_0000001103383404_row66922014195511"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p166924144558"><a name="zh-cn_topic_0000001103383404_p166924144558"></a><a name="zh-cn_topic_0000001103383404_p166924144558"></a>pause</p> 504</td> 505<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p1369261410553"><a name="zh-cn_topic_0000001103383404_p1369261410553"></a><a name="zh-cn_topic_0000001103383404_p1369261410553"></a>-</p> 506</td> 507<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p186928147554"><a name="zh-cn_topic_0000001103383404_p186928147554"></a><a name="zh-cn_topic_0000001103383404_p186928147554"></a>完成pause方法调用，音频暂停播放，触发该事件。</p> 508</td> 509</tr> 510<tr id="zh-cn_topic_0000001103383404_row19692151435518"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p36929145556"><a name="zh-cn_topic_0000001103383404_p36929145556"></a><a name="zh-cn_topic_0000001103383404_p36929145556"></a>stop</p> 511</td> 512<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p12692181412556"><a name="zh-cn_topic_0000001103383404_p12692181412556"></a><a name="zh-cn_topic_0000001103383404_p12692181412556"></a>-</p> 513</td> 514<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p176921414175520"><a name="zh-cn_topic_0000001103383404_p176921414175520"></a><a name="zh-cn_topic_0000001103383404_p176921414175520"></a>完成stop方法调用，音频停止播放，触发该事件。</p> 515</td> 516</tr> 517<tr id="zh-cn_topic_0000001103383404_row471819386316"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p471953813113"><a name="zh-cn_topic_0000001103383404_p471953813113"></a><a name="zh-cn_topic_0000001103383404_p471953813113"></a>reset</p> 518</td> 519<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p11719338123110"><a name="zh-cn_topic_0000001103383404_p11719338123110"></a><a name="zh-cn_topic_0000001103383404_p11719338123110"></a>-</p> 520</td> 521<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p8719123833111"><a name="zh-cn_topic_0000001103383404_p8719123833111"></a><a name="zh-cn_topic_0000001103383404_p8719123833111"></a>完成reset方法调用，释放音频播放资源，触发该事件。</p> 522</td> 523</tr> 524<tr id="zh-cn_topic_0000001103383404_row53036474012"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p830454715010"><a name="zh-cn_topic_0000001103383404_p830454715010"></a><a name="zh-cn_topic_0000001103383404_p830454715010"></a>dataLoad</p> 525</td> 526<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p73046471703"><a name="zh-cn_topic_0000001103383404_p73046471703"></a><a name="zh-cn_topic_0000001103383404_p73046471703"></a>-</p> 527</td> 528<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p43041247401"><a name="zh-cn_topic_0000001103383404_p43041247401"></a><a name="zh-cn_topic_0000001103383404_p43041247401"></a>完成音频数据加载后触发该事件。</p> 529</td> 530</tr> 531<tr id="zh-cn_topic_0000001103383404_row126921114175516"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p169271475516"><a name="zh-cn_topic_0000001103383404_p169271475516"></a><a name="zh-cn_topic_0000001103383404_p169271475516"></a>finish</p> 532</td> 533<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p106924149554"><a name="zh-cn_topic_0000001103383404_p106924149554"></a><a name="zh-cn_topic_0000001103383404_p106924149554"></a>-</p> 534</td> 535<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p19692161445511"><a name="zh-cn_topic_0000001103383404_p19692161445511"></a><a name="zh-cn_topic_0000001103383404_p19692161445511"></a>完成音频播放后触发该事件。</p> 536</td> 537</tr> 538<tr id="zh-cn_topic_0000001103383404_row1869318146557"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p769313145553"><a name="zh-cn_topic_0000001103383404_p769313145553"></a><a name="zh-cn_topic_0000001103383404_p769313145553"></a>volumeChange</p> 539</td> 540<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p9693814195516"><a name="zh-cn_topic_0000001103383404_p9693814195516"></a><a name="zh-cn_topic_0000001103383404_p9693814195516"></a>-</p> 541</td> 542<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p369321412558"><a name="zh-cn_topic_0000001103383404_p369321412558"></a><a name="zh-cn_topic_0000001103383404_p369321412558"></a>播放音量改变后触发该事件。</p> 543</td> 544</tr> 545<tr id="zh-cn_topic_0000001103383404_row19142191516210"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p10143151513220"><a name="zh-cn_topic_0000001103383404_p10143151513220"></a><a name="zh-cn_topic_0000001103383404_p10143151513220"></a>timeUpdate</p> 546</td> 547<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p614311152215"><a name="zh-cn_topic_0000001103383404_p614311152215"></a><a name="zh-cn_topic_0000001103383404_p614311152215"></a>-</p> 548</td> 549<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p614351513214"><a name="zh-cn_topic_0000001103383404_p614351513214"></a><a name="zh-cn_topic_0000001103383404_p614351513214"></a>完成seek方法调用，音频播放时间戳更新，触发该事件。</p> 550</td> 551</tr> 552<tr id="zh-cn_topic_0000001103383404_row1469142035618"><td class="cellrowborder" valign="top" width="21.542154215421544%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001103383404_p18701220185614"><a name="zh-cn_topic_0000001103383404_p18701220185614"></a><a name="zh-cn_topic_0000001103383404_p18701220185614"></a>error</p> 553</td> 554<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001103383404_p27013201562"><a name="zh-cn_topic_0000001103383404_p27013201562"></a><a name="zh-cn_topic_0000001103383404_p27013201562"></a><a href="#zh-cn_topic_0000001103383404_table2584191811710">callback</a></p> 555</td> 556<td class="cellrowborder" valign="top" width="56.46564656465647%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001103383404_p8700209561"><a name="zh-cn_topic_0000001103383404_p8700209561"></a><a name="zh-cn_topic_0000001103383404_p8700209561"></a>音频播放中发生错误，触发该事件。</p> 557</td> 558</tr> 559</tbody> 560</table> 561 562**表 1** error事件的参数说明 563 564<a name="zh-cn_topic_0000001103383404_table2584191811710"></a> 565<table><thead align="left"><tr id="zh-cn_topic_0000001103383404_row3584101817714"><th class="cellrowborder" valign="top" width="21.62216221622162%" id="mcps1.2.4.1.1"><p id="zh-cn_topic_0000001103383404_p97918291679"><a name="zh-cn_topic_0000001103383404_p97918291679"></a><a name="zh-cn_topic_0000001103383404_p97918291679"></a>参数名</p> 566</th> 567<th class="cellrowborder" valign="top" width="23.82238223822382%" id="mcps1.2.4.1.2"><p id="zh-cn_topic_0000001103383404_p1579262919717"><a name="zh-cn_topic_0000001103383404_p1579262919717"></a><a name="zh-cn_topic_0000001103383404_p1579262919717"></a>类型</p> 568</th> 569<th class="cellrowborder" valign="top" width="54.55545554555455%" id="mcps1.2.4.1.3"><p id="zh-cn_topic_0000001103383404_p1979218299715"><a name="zh-cn_topic_0000001103383404_p1979218299715"></a><a name="zh-cn_topic_0000001103383404_p1979218299715"></a>说明</p> 570</th> 571</tr> 572</thead> 573<tbody><tr id="zh-cn_topic_0000001103383404_row9585171814711"><td class="cellrowborder" valign="top" width="21.62216221622162%" headers="mcps1.2.4.1.1 "><p id="zh-cn_topic_0000001103383404_p779213291717"><a name="zh-cn_topic_0000001103383404_p779213291717"></a><a name="zh-cn_topic_0000001103383404_p779213291717"></a>callback</p> 574</td> 575<td class="cellrowborder" valign="top" width="23.82238223822382%" headers="mcps1.2.4.1.2 "><p id="zh-cn_topic_0000001103383404_p679202917711"><a name="zh-cn_topic_0000001103383404_p679202917711"></a><a name="zh-cn_topic_0000001103383404_p679202917711"></a>ErrorCallback</p> 576</td> 577<td class="cellrowborder" valign="top" width="54.55545554555455%" headers="mcps1.2.4.1.3 "><p id="zh-cn_topic_0000001103383404_p9792142920716"><a name="zh-cn_topic_0000001103383404_p9792142920716"></a><a name="zh-cn_topic_0000001103383404_p9792142920716"></a>错误事件的回调函数。</p> 578</td> 579</tr> 580</tbody> 581</table> 582 583## AudioState<a name="zh-cn_topic_0000001103383404_section5181155710523"></a> 584 585音频播放的状态机。 586 587<a name="zh-cn_topic_0000001103383404_table919114616314"></a> 588<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> 589</th> 590<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> 591</th> 592</tr> 593</thead> 594<tbody><tr id="zh-cn_topic_0000001103383404_row3427194315719"><td class="cellrowborder" valign="top" width="33.739999999999995%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001103383404_p642711431172"><a name="zh-cn_topic_0000001103383404_p642711431172"></a><a name="zh-cn_topic_0000001103383404_p642711431172"></a>idle</p> 595</td> 596<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001103383404_p24281543777"><a name="zh-cn_topic_0000001103383404_p24281543777"></a><a name="zh-cn_topic_0000001103383404_p24281543777"></a>音频播放空闲。</p> 597</td> 598</tr> 599<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> 600</td> 601<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> 602</td> 603</tr> 604<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> 605</td> 606<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> 607</td> 608</tr> 609<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> 610</td> 611<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> 612</td> 613</tr> 614</tbody> 615</table> 616 617