閱讀(46.4k) 書簽贊(0) 我要糾錯(cuò)

微信小程序API 背景音頻播放管理

2020-07-28 14:19 更新

wx.getBackgroundAudioManager()

基礎(chǔ)庫(kù) 1.2.0 開始支持，低版本需做兼容處理

獲取全局唯一的背景音頻管理器backgroundAudioManager

backgroundAudioManager

backgroundAudioManager 對(duì)象的屬性列表：

屬性	類型	說(shuō)明	只讀
duration	Number	當(dāng)前音頻的長(zhǎng)度（單位：s），只有在當(dāng)前有合法的 src 時(shí)返回	是
currentTime	Number	當(dāng)前音頻的播放位置（單位：s），只有在當(dāng)前有合法的 src 時(shí)返回	是
paused	Boolean	當(dāng)前是是否暫?；蛲Ｖ?fàn)顟B(tài)，true 表示暫?；蛲Ｖ?，false 表示正在播放	是
src	String	音頻的數(shù)據(jù)源，默認(rèn)為空字符串，當(dāng)設(shè)置了新的 src 時(shí)，會(huì)自動(dòng)開始播放，目前支持的格式有 m4a, aac, mp3, wav	否
startTime	Number	音頻開始播放的位置（單位：s）	否
buffered	Number	音頻緩沖的時(shí)間點(diǎn)，僅保證當(dāng)前播放時(shí)間點(diǎn)到此時(shí)間點(diǎn)內(nèi)容已緩沖。	是
title	String	音頻標(biāo)題，用于做原生音頻播放器音頻標(biāo)題。原生音頻播放器中的分享功能，分享出去的卡片標(biāo)題，也將使用該值。	否
epname	String	專輯名，原生音頻播放器中的分享功能，分享出去的卡片簡(jiǎn)介，也將使用該值。	否
singer	String	歌手名，原生音頻播放器中的分享功能，分享出去的卡片簡(jiǎn)介，也將使用該值。	否
coverImgUrl	String	封面圖url，用于做原生音頻播放器背景圖。原生音頻播放器中的分享功能，分享出去的卡片配圖及背景也將使用該圖。	否
webUrl	String	頁(yè)面鏈接，原生音頻播放器中的分享功能，分享出去的卡片簡(jiǎn)介，也將使用該值。	否

backgroundAudioManager 對(duì)象的方法列表：

方法	參數(shù)	說(shuō)明
play		播放
pause		暫停
stop		停止
seek	position	跳轉(zhuǎn)到指定位置，單位 s
onCanplay	callback	背景音頻進(jìn)入可以播放狀態(tài)，但不保證后面可以流暢播放
onPlay	callback	背景音頻播放事件
onPause	callback	背景音頻暫停事件
onStop	callback	背景音頻停止事件
onEnded	callback	背景音頻自然播放結(jié)束事件
onTimeUpdate	callback	背景音頻播放進(jìn)度更新事件
onPrev	callback	用戶在系統(tǒng)音樂播放面板點(diǎn)擊上一曲事件（iOS only）
onNext	callback	用戶在系統(tǒng)音樂播放面板點(diǎn)擊下一曲事件（iOS only）
onError	callback	背景音頻播放錯(cuò)誤事件
onWaiting	callback	音頻加載中事件，當(dāng)音頻因?yàn)閿?shù)據(jù)不足，需要停下來(lái)加載時(shí)會(huì)觸發(fā)

errcode 說(shuō)明

errCode	說(shuō)明
10001	系統(tǒng)錯(cuò)誤
10002	網(wǎng)絡(luò)錯(cuò)誤
10003	文件錯(cuò)誤
10004	格式錯(cuò)誤
-1	未知錯(cuò)誤

示例代碼：

const backgroundAudioManager = wx.getBackgroundAudioManager()

backgroundAudioManager.title = '此時(shí)此刻'
backgroundAudioManager.epname = '此時(shí)此刻'
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' // 設(shè)置了 src 之后會(huì)自動(dòng)播放

以上內(nèi)容是否對(duì)您有幫助：

寫筆記

我要補(bǔ)充

微信小程序API 背景音頻播放管理

wx.getBackgroundAudioManager()

backgroundAudioManager

推薦文章

推薦教程

推薦課程