基础库 1.2.0 开始支持,低版本需做兼容处理
获取全局唯一的背景音频管理器backgroundaudiomanager
backgroundaudiomanager 对象的属性列表:
属性 | 类型 | 说明 | 只读 |
---|---|---|---|
duration | number | 当前音频的长度(单位:s),只有在当前有合法的 src 时返回 | 是 |
currenttime | number | 当前音频的播放位置(单位:s),只有在当前有合法的 src 时返回 | 是 |
paused | boolean | 当前是是否暂停或停止状态,true 表示暂停或停止,false 表示正在播放 | 是 |
src | string | 音频的数据源,默认为空字符串,当设置了新的 src 时,会自动开始播放 ,目前支持的格式有 m4a, aac, mp3, wav | 否 |
starttime | number | 音频开始播放的位置(单位:s) | 否 |
buffered | number | 音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲。 | 是 |
title | string | 音频标题,用于做原生音频播放器音频标题。原生音频播放器中的分享功能,分享出去的卡片标题,也将使用该值。 | 否 |
epname | string | 专辑名,原生音频播放器中的分享功能,分享出去的卡片简介,也将使用该值。 | 否 |
singer | string | 歌手名,原生音频播放器中的分享功能,分享出去的卡片简介,也将使用该值。 | 否 |
coverimgurl | string | 封面图url,用于做原生音频播放器背景图。原生音频播放器中的分享功能,分享出去的卡片配图及背景也将使用该图。 | 否 |
weburl | string | 页面链接,原生音频播放器中的分享功能,分享出去的卡片简介,也将使用该值。 | 否 |
backgroundaudiomanager 对象的方法列表:
方法 | 参数 | 说明 |
---|---|---|
play | 播放 | |
pause | 暂停 | |
stop | 停止 | |
seek | position | 跳转到指定位置,单位 s |
oncanplay | callback | 背景音频进入可以播放状态,但不保证后面可以流畅播放 |
onplay | callback | 背景音频播放事件 |
onpause | callback | 背景音频暂停事件 |
onstop | callback | 背景音频停止事件 |
onended | callback | 背景音频自然播放结束事件 |
ontimeupdate | callback | 背景音频播放进度更新事件 |
onprev | callback | 用户在系统音乐播放面板点击上一曲事件(ios only) |
onnext | callback | 用户在系统音乐播放面板点击下一曲事件(ios only) |
onerror | callback | 背景音频播放错误事件 |
onwaiting | callback | 音频加载中事件,当音频因为数据不足,需要停下来加载时会触发 |
errcode 说明
errcode | 说明 |
---|---|
10001 | 系统错误 |
10002 | 网络错误 |
10003 | 文件错误 |
10004 | 格式错误 |
-1 | 未知错误 |
示例代码:
const backgroundaudiomanager = wx.getbackgroundaudiomanager()
backgroundaudiomanager.title = '此时此刻'
backgroundaudiomanager.epname = '此时此刻'
backgroundaudiomanager.singer = '汪峰'
backgroundaudiomanager.coverimgurl = 'http://y.gtimg.cn/music/photo_new/t002r300x300m000003rskf44gyask.jpg?max_age=2592000'
backgroundaudiomanager.src = 'http://ws.stream.qqmusic.qq.com/m500001vfvsj21xfqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292f51e1e384e061ff02c31f716658e5c81f5594d561f2e88b854e81caab7806d5e4f103e55d33c16f3fac506d1ab172de8600b37e43fad&fromtag=46' // 设置了 src 之后会自动播放