微信小程序API背景音頻播放管理,背景音頻管理器backgroundAudioManager
2017-12-22
導讀:wx.getBackgroundAudioManager() 基礎(chǔ)庫 1.2.0 開始支持,低版本需做兼容處理 獲取 全局唯一 的背景音頻管理器 backgroundAudioManager backgroundAudioManager backgroundAudioManager 對象的屬性列表: 屬性 類型...
wx.getBackgroundAudioManager()
基礎(chǔ)庫 1.2.0 開始支持,低版本需做兼容處理
獲取全局唯一的背景音頻管理器backgroundAudioManager
backgroundAudioManager
backgroundAudioManager 對象的屬性列表:
屬性 | 類型 | 說明 | 只讀 |
---|---|---|---|
duration | Number | 當前音頻的長度(單位:s),只有在當前有合法的 src 時返回 | 是 |
currentTime | Number | 當前音頻的播放位置(單位:s),只有在當前有合法的 src 時返回 | 是 |
paused | Boolean | 當前是是否暫?;蛲V範顟B(tài),true 表示暫?;蛲V梗琭alse 表示正在播放 | 是 |
src | String | 音頻的數(shù)據(jù)源,默認為空字符串,當設(shè)置了新的 src 時,會自動開始播放 ,目前支持的格式有 m4a, aac, mp3, wav | 否 |
startTime | Number | 音頻開始播放的位置(單位:s) | 否 |
buffered | Number | 音頻緩沖的時間點,僅保證當前播放時間點到此時間點內(nèi)容已緩沖。 | 是 |
title | String | 音頻標題,用于做原生音頻播放器音頻標題。原生音頻播放器中的分享功能,分享出去的卡片標題,也將使用該值。 | 否 |
epname | String | 專輯名,原生音頻播放器中的分享功能,分享出去的卡片簡介,也將使用該值。 | 否 |
singer | String | 歌手名,原生音頻播放器中的分享功能,分享出去的卡片簡介,也將使用該值。 | 否 |
coverImgUrl | String | 封面圖url,用于做原生音頻播放器背景圖。原生音頻播放器中的分享功能,分享出去的卡片配圖及背景也將使用該圖。 | 否 |
webUrl | String | 頁面鏈接,原生音頻播放器中的分享功能,分享出去的卡片簡介,也將使用該值。 | 否 |
backgroundAudioManager 對象的方法列表:
方法 | 參數(shù) | 說明 |
---|---|---|
play | 播放 | |
pause | 暫停 | |
stop | 停止 | |
seek | position | 跳轉(zhuǎn)到指定位置,單位 s |
onCanplay | callback | 背景音頻進入可以播放狀態(tài),但不保證后面可以流暢播放 |
onPlay | callback | 背景音頻播放事件 |
onPause | callback | 背景音頻暫停事件 |
onStop | callback | 背景音頻停止事件 |
onEnded | callback | 背景音頻自然播放結(jié)束事件 |
onTimeUpdate | callback | 背景音頻播放進度更新事件 |
onPrev | callback | 用戶在系統(tǒng)音樂播放面板點擊上一曲事件(iOS only) |
onNext | callback | 用戶在系統(tǒng)音樂播放面板點擊下一曲事件(iOS only) |
onError | callback | 背景音頻播放錯誤事件 |
onWaiting | callback | 音頻加載中事件,當音頻因為數(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 之后會自動播放
更多微信小程序開發(fā)教程,可以關(guān)注hi小程序。
第二部分:如何開通一個小商店