注冊(cè)

微信小程序API 音樂播放控制

2018-03-21
導(dǎo)讀:基礎(chǔ)庫(kù) 1.2.0 開始支持,低版本需做 兼容處理 獲取 全局唯一 的背景音頻管理器 backgroundAudioManager 。 backgroundAudioManager backgroundAudioManager 對(duì)象的屬性列表: 屬性 類型 說明 只讀 duration...

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

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

backgroundAudioManager

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

屬性 類型 說明 只讀
duration Number 當(dāng)前音頻的長(zhǎ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 表示暫?;蛲V梗琭alse 表示正在播放
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ù) 說明
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)播放
重磅推薦:小程序開店目錄

第一部分:小商店是什么

第二部分:如何開通一個(gè)小商店

第三部分:如何登錄小商店

第四部分:開店任務(wù)常見問題

第五部分:小商店可以賣什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結(jié)算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開發(fā)