背景音频 - BackgroundAudioManager - 《Taro v3.0 API文档》

方法
示例代码

BackgroundAudioManager 实例，可通过 Taro.getBackgroundAudioManager 获取。

参考文档

方法

参数	类型	只读	说明
buffered	`number`	是	音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
coverImgUrl	`string`	否	封面图 URL，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图。
currentTime	`number`	是	当前音频的播放位置（单位：s），只有在有合法 src 时返回。
duration	`number`	是	当前音频的长度（单位：s），只有在有合法 src 时返回。
epname	`string`	否	专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。
paused	`boolean`	是	当前是否暂停或停止。
protocol	`string`	否	音频协议。默认值为 ‘http’，设置 ‘hls’ 可以支持播放 HLS 协议的直播音频。
singer	`string`	否	歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。
src	`string`	否	音频的数据源（2.2.3 开始支持云文件ID）。默认为空字符串，当设置了新的 src 时，会自动开始播放，目前支持的格式有 m4a, aac, mp3, wav。
startTime	`number`	否	音频开始播放的位置（单位：s）。
title	`string`	否	音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。
webUrl	`string`	否	页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。

play

播放

() => void

pause

暂停

() => void

stop

停止

() => void

seek

跳转到指定位置，单位 s

(position: any) => void

onCanplay

背景音频进入可以播放状态，但不保证后面可以流畅播放

(callback?: () => void) => void

参数	类型
callback	`() => void`

onPlay

背景音频播放事件

(callback?: () => void) => void

参数	类型
callback	`() => void`

onPause

背景音频暂停事件

(callback?: () => void) => void

参数	类型
callback	`() => void`

onStop

背景音频停止事件

(callback?: () => void) => void

参数	类型
callback	`() => void`

onEnded

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

(callback?: () => void) => void

参数	类型
callback	`() => void`

onTimeUpdate

背景音频播放进度更新事件

(callback?: () => void) => void

参数	类型
callback	`() => void`

onPrev

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

(callback?: () => void) => void

参数	类型
callback	`() => void`

onNext

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

(callback?: () => void) => void

参数	类型
callback	`() => void`

onError

背景音频播放错误事件

(callback?: () => void) => void

参数	类型
callback	`() => void`

onWaiting

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

(callback?: () => void) => void

参数	类型
callback	`() => void`

示例代码

const backgroundAudioManager = Taro.getBackgroundAudioManager()
backgroundAudioManager.title = '此时此刻'
backgroundAudioManager.epname = '此时此刻'
backgroundAudioManager.singer = '许巍'
backgroundAudioManager.coverImgUrl = 'https://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
// 设置了 src 之后会自动播放
backgroundAudioManager.src = 'https://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'