
-
wx.seekBackgroundAudio(OBJECT)
作用:控制音樂播放進度。
注意: 該事件 會觸發 wx.onBackgroundAudioPlay(CALLBACK) 事件 ,也就是相當於在調整進度后,后台會自動的調用wx.playBackgroundAudio(OBJECT)函數。
-
使用 audio組件 制作的播放器,即使點擊"顯示在微信頂部",音樂依然會停止,使用 wx.playBackgroundAudio 相關API制作的播放器才不會。
-
wx.playBackgroundAudio(OBJECT),wx.pauseBackgroundAudio(),wx.seekBackgroundAudio(OBJECT),wx.stopBackgroundAudio()
注意:上述四個操作都是 異步操作,都可以設置OBJECT參數,都有 success , fail , complete 回調 ,參照 wx.playBackgroundAudio(OBJECT) 的 OBJECT說明,OBJECT說明
-
后台播放音樂暫停后怎么從上次播放的地方繼續播放?
-
使用 seekBackgroundAudio。
官網並沒有相關解釋,初步思路是使用 playBackgroundAudio 播放音樂后,再調用 seekBackgroundAudio 將進度調整到上次停止的地方,但是由上面的第一條所描述,這樣做的結果會導致onBackgroundAudioPlay 會被觸發兩次,所以我們可以直接調用seekBackgroundAudio調整播放進度即可(前提是之前有播放過歌曲,就是確保歌曲地址已經被設置,不然無效),隨后音樂會自動播放.
-
使用 playBackgroundAudio
經測試調用playBackgroundAudio,並且傳入的歌曲地址參數和上次相同時,歌曲會從上次暫停的時間位置繼續播放
-
-
wx.stopBackgroundAudio
注意:經測試,再調用 wx.stopBackgroundAudio 函數之后,緊接着調用 wx.playBackgroundAudio ,在pc端模擬測試時正常,后台會停止播放音樂,然后再播放新的音樂,但是,在手機上卻會打斷緊接着調用的 wx.playBackgroundAudio 的播放(坑啊T-T),測試真機為phone5。
-
回調函數的觸發時機。
-
wx.onBackgroundAudioPlay(CALLBACK) 監聽音樂播放。
-
wx.onBackgroundAudioPause(CALLBACK) 監聽音樂暫停。
-
wx.onBackgroundAudioStop(CALLBACK) 監聽音樂停止。
上述監聽函數會在調用對應的wx.playBackgroundAudio(OBJECT),wx.pauseBackgroundAudio(),wx.stopBackgroundAudio()等函數時,會被立即觸發,對應的操作可能並沒有完成,比如調用 playBackgroundAudio播放音樂,只是給后台發送信息,要播放音樂,但是此時音樂並沒有開始播放,可能還在加載等等,但是onBackgroundAudioPlay的回調函數會立即調用。
而wx.playBackgroundAudio(OBJECT),wx.pauseBackgroundAudio(OBJECT),wx.seekBackgroundAudio(OBJECT),wx.stopBackgroundAudio(OBJECT)中OBJECT里面的回調函數會在如下對應條件觸發:
-
在歌曲加載完成之后,可以播放時觸發
-
在歌曲暫停之后,沒有聲音之后觸發
-
歌曲進度設置完成並且開始播放之后觸發
-
歌曲停止之后觸發
wx.onBackgroundAudioPlay(CALLBACK) , wx.onBackgroundAudioPause(CALLBACK) , wx.onBackgroundAudioStop(CALLBACK) 函數可以監聽后台操作歌曲時,觸發的事件,比如當小程序退出后,音樂暫停,也包括我們使用 wx.pauseBackgroundAudio 等函數時觸發的事件。
在wx.onBackgroundAudioPause(OBJECT)里面的 暫停回調函數函數不會被觸發,wx.pauseBackgroundAudio(OBJECT)里面的回調函數只是當次主動操作有效。后台自動暫停歌曲時並不會觸發該回調函數,wx.playBackgroundAudio(OBJECT),wx.pauseBackgroundAudio(),wx.seekBackgroundAudio(OBJECT),wx.stopBackgroundAudio()都是一樣的機制。
-
-
怎么獲取歌曲播放時的 回調函數?
微信小程序官方文檔,playBackgroundAudio相關額API並沒有提供此函數,但是提供了wx.getBackgroundAudioPlayerState函數用於獲取歌曲播放時歌曲額進度信息,所以我們可以使用setInterval定時函數模擬這個事件。下面是我模擬的相關事件,
var timer = setInterval(() => {
wx.getBackgroundAudioPlayerState({
success:function(res){
//調用需要更新的
//self._onUpdate(res);
}
});
}, 500);
- 最重要的一點,pc端的模擬器,上面描述的事件觸的順序會可能和手機端的觸發順序不一樣(T-T,天坑,本來調試好好的,pc端app突然就抽風,炸了,有時候播放歌曲后 立刻就暫停,至今不知道是為什么,手機端卻是正常的),所以還是多真機調試吧,都是淚。
