微信小程序API背景音頻播放管理,背景音頻管理器backgroundAudioManager
2017-12-22
導(dǎo)讀：wx.getBackgroundAudioManager() 基礎(chǔ)庫 1.2.0 開始支持，低版本需做兼容處理 獲取 全局唯一 的背景音頻管理器 backgroundAudioManager backgroundAudioManager backgroundAudioManager 對(duì)象的屬性列表： 屬性 類型...
wx.getBackgroundAudioManager()
基礎(chǔ)庫 1.2.0 開始支持，低版本需做兼容處理
獲取全局唯一的背景音頻管理器backgroundAudioManager
backgroundAudioManager
backgroundAudioManager 對(duì)象的屬性列表：
| 屬性 | 類型 | 說明 | 只讀 |
|---|---|---|---|
| duration | Number | 當(dā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 | 專輯名，原生音頻播放器中的分享功能，分享出去的卡片簡介，也將使用該值。 | 否 |
| singer | String | 歌手名，原生音頻播放器中的分享功能，分享出去的卡片簡介，也將使用該值。 | 否 |
| coverImgUrl | String | 封面圖url，用于做原生音頻播放器背景圖。原生音頻播放器中的分享功能，分享出去的卡片配圖及背景也將使用該圖。 | 否 |
| webUrl | String | 頁面鏈接，原生音頻播放器中的分享功能，分享出去的卡片簡介，也將使用該值。 | 否 |
backgroundAudioManager 對(duì)象的方法列表：
| 方法 | 參數(shù) | 說明 |
|---|---|---|
| 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ù)不足，需要停下來加載時(shí)會(huì)觸發(fā) |
errcode 說明
| errCode | 說明 |
|---|---|
| 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)播放
更多微信小程序開發(fā)教程，可以關(guān)注hi小程序。
第二部分：如何開通一個(gè)小商店
掃碼免費(fèi)領(lǐng)取運(yùn)營資料包
