1. 属性说明

（1）BackgroundAudioManager类属性

BackgroundAudioManager类为全局唯一的背景音频管理器。可通过API函数wx.getBackgroundAudioManager获取，当小程序切入后台时，如果音频处于播放状态，可以继续播放。但是后台状态不能通过调用API操纵音频的播放状态。

注意：从微信客户端6.7.2版本开始，若需要在小程序切后台后继续播放音频，需要在app.json 中配置 requiredBackgroundModes属性。开发版和体验版上可以直接生效，正式版还需通过审核。

表【】BackgroundAudioManager类属性名

属性名

类型

说明

src

string

音频的数据源（2.2.3 开始支持云文件ID）。默认为空字符串，当设置了新的 src 时，会自动开始播放，目前支持的格式有 m4a, aac, mp3, wav。

startTime

number

音频开始播放的位置（单位：s）。

title

string

音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。

epname

string

专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。

singer

string

歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。

coverImgUrl

string

封面图 URL，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图。

webUrl

string

页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。

protocol

string

音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。

duration

number

当前音频的长度（单位：s），只有在有合法 src 时返回。（只读）

currentTime

number

当前音频的播放位置（单位：s），只有在有合法 src 时返回。（只读）

paused

boolean

当前是否暂停或停止。（只读）

buffered

number

音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。（只读）

（2）BackgroundAudioManager类方法

BackgroundAudioManager所有类方法如表【】所示。

表【】BackgroundAudioManager类方法说明

方法名

说明

BackgroundAudioManager.play()

播放音乐

BackgroundAudioManager.pause()

暂停音乐

BackgroundAudioManager.seek(number currentTime)

跳转到指定位置

BackgroundAudioManager.stop()

停止音乐

BackgroundAudioManager.onCanplay(function callback)

监听背景音频进入可播放状态事件。 但不保证后面可以流畅播放

BackgroundAudioManager.onWaiting(function callback)

监听音频加载中事件。当音频因为数据不足，需要停下来加载时会触发

BackgroundAudioManager.onError(function callback)

监听背景音频播放错误事件

BackgroundAudioManager.onPlay(function callback)

监听背景音频播放事件

BackgroundAudioManager.onPause(function callback)

监听背景音频暂停事件

BackgroundAudioManager.onSeeking(function callback)

监听背景音频开始跳转操作事件

BackgroundAudioManager.onSeeked(function callback)

监听背景音频完成跳转操作事件

BackgroundAudioManager.onEnded(function callback)

监听背景音频自然播放结束事件

BackgroundAudioManager.onStop(function callback)

监听背景音频停止事件

BackgroundAudioManager.onTimeUpdate(function callback)

监听背景音频播放进度更新事件，只有小程序在前台时会回调。

BackgroundAudioManager.onNext(function callback)

监听用户在系统音乐播放面板点击下一曲事件（仅iOS）

BackgroundAudioManager.onPrev(function callback)

监听用户在系统音乐播放面板点击上一曲事件（仅iOS）

2. 编码测试

新建backgroundAudio页面，在WXML中添加如下代码：