# audio

从基础库 1.6.0 开始,本接口停止维护,请使用 wx.createInnerAudioContext 代替

基础库 1.0.0 开始支持,低版本需做兼容处理。

相关文档: wx.createAudioContext

渲染框架支持情况:Skyline (使用最新 Nightly 工具调试)、WebView

# 功能描述

音频。

# 属性说明

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

# MediaError.code

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

# 示例代码

在开发者工具中预览效果