注冊

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

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

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

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

backgroundAudioManager

backgroundAudioManager 對象的屬性列表:

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

backgroundAudioManager 對象的方法列表:

方法 參數(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 背景音頻播放錯誤事件
onWaiting callback 音頻加載中事件,當(dāng)音頻因?yàn)閿?shù)據(jù)不足,需要停下來加載時會觸發(fā)

errcode 說明

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

示例代碼:

const backgroundAudioManager = wx.getBackgroundAudioManager()

backgroundAudioManager.title = '此時此刻'
backgroundAudioManager.epname = '此時此刻'
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 之后會自動播放
重磅推薦:小程序開店目錄

第一部分:小商店是什么

第二部分:如何開通一個小商店

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

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

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

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

第七部分:小程序直播

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

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

第十部分:小程序客服

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

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