# audio

从基础库 [1.6.0](1003706) 开始，本接口停止维护，请使用 [wx.createInnerAudioContext](/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.md) 代替

> 基础库 1.0.0 开始支持，低版本需做[兼容处理](1003706)。

> 相关文档: [wx.createAudioContext](/miniprogram/dev/api/media/audio/wx.createAudioContext.md)

渲染框架支持情况：Skyline （使用最新 [Nightly](/miniprogram/dev/devtools/nightly.html) 工具调试）、WebView

## 功能描述

音频。

## 属性说明

| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
| ---- | ---- | ------ | -------- | ---- | -------- |
| id | string |  | 否 | audio 组件的唯一标识符 | [1.0.0](1003706) |
| src | string |  | 否 | 要播放音频的资源地址 | [1.0.0](1003706) |
| loop | boolean | false | 否 | 是否循环播放 | [1.0.0](1003706) |
| controls | boolean | false | 否 | 是否显示默认控件 | [1.0.0](1003706) |
| poster | string |  | 否 | 默认控件上的音频封面的图片资源地址，如果 controls 属性值为 false 则设置 poster 无效 | [1.0.0](1003706) |
| name | string | 未知音频 | 否 | 默认控件上的音频名字，如果 controls 属性值为 false 则设置 name 无效 | [1.0.0](1003706) |
| author | string | 未知作者 | 否 | 默认控件上的作者名字，如果 controls 属性值为 false 则设置 author 无效 | [1.0.0](1003706) |
| bind:error | eventhandle |  | 否 | 当发生错误时触发 error 事件，detail = {errMsg:MediaError.code} | [1.0.0](1003706) |
| bind:play | eventhandle |  | 否 | 当开始/继续播放时触发play事件 | [1.0.0](1003706) |
| bind:pause | eventhandle |  | 否 | 当暂停播放时触发 pause 事件 | [1.0.0](1003706) |
| bind:timeupdate | eventhandle |  | 否 | 当播放进度改变时触发 timeupdate 事件，detail = {currentTime, duration} | [1.0.0](1003706) |
| bind:ended | eventhandle |  | 否 | 当播放到末尾时触发 ended 事件 | [1.0.0](1003706) |

## MediaError.code

| 返回错误码 | 描述               |
|------------|--------------------|
| 1          | 获取资源被用户禁止 |
| 2          | 网络错误           |
| 3          | 解码错误           |
| 4          | 不合适资源         |

## 示例代码

[在开发者工具中预览效果](https://developers.weixin.qq.com/s/NycgqcmS6KYY)