微信小程序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)前是是否暫?;蛲V?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è)小商店