微信小程序后台音樂播放注意事項


  1. wx.seekBackgroundAudio(OBJECT)

    作用:控制音樂播放進度。

    注意: 該事件 會觸發 wx.onBackgroundAudioPlay(CALLBACK) 事件 ,也就是相當於在調整進度后,后台會自動的調用wx.playBackgroundAudio(OBJECT)函數。

  2. 使用 audio組件 制作的播放器,即使點擊"顯示在微信頂部",音樂依然會停止,使用 wx.playBackgroundAudio 相關API制作的播放器才不會。

  3. wx.playBackgroundAudio(OBJECT),wx.pauseBackgroundAudio(),wx.seekBackgroundAudio(OBJECT),wx.stopBackgroundAudio()

    注意:上述四個操作都是 異步操作,都可以設置OBJECT參數,都有 success , fail , complete 回調 ,參照 wx.playBackgroundAudio(OBJECT) 的 OBJECT說明,OBJECT說明

  4. 后台播放音樂暫停后怎么從上次播放的地方繼續播放?

    • 使用 seekBackgroundAudio

      官網並沒有相關解釋,初步思路是使用 playBackgroundAudio 播放音樂后,再調用 seekBackgroundAudio 將進度調整到上次停止的地方,但是由上面的第一條所描述,這樣做的結果會導致onBackgroundAudioPlay 會被觸發兩次,所以我們可以直接調用seekBackgroundAudio調整播放進度即可(前提是之前有播放過歌曲,就是確保歌曲地址已經被設置,不然無效),隨后音樂會自動播放.

    • 使用 playBackgroundAudio

      經測試調用playBackgroundAudio,並且傳入的歌曲地址參數和上次相同時,歌曲會從上次暫停的時間位置繼續播放

  5. wx.stopBackgroundAudio

    注意:經測試,再調用 wx.stopBackgroundAudio 函數之后,緊接着調用 wx.playBackgroundAudio ,在pc端模擬測試時正常,后台會停止播放音樂,然后再播放新的音樂,但是,在手機上卻會打斷緊接着調用的 wx.playBackgroundAudio 的播放(坑啊T-T),測試真機為phone5。

  6. 回調函數的觸發時機。

    • 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()都是一樣的機制。

  7. 怎么獲取歌曲播放時的 回調函數?

    微信小程序官方文檔,playBackgroundAudio相關額API並沒有提供此函數,但是提供了wx.getBackgroundAudioPlayerState函數用於獲取歌曲播放時歌曲額進度信息,所以我們可以使用setInterval定時函數模擬這個事件。下面是我模擬的相關事件,

    var timer = setInterval(() => {
        wx.getBackgroundAudioPlayerState({
            success:function(res){
                //調用需要更新的
                //self._onUpdate(res);
            }
        });
    }, 500);
  1. 最重要的一點,pc端的模擬器,上面描述的事件觸的順序會可能和手機端的觸發順序不一樣(T-T,天坑,本來調試好好的,pc端app突然就抽風,炸了,有時候播放歌曲后 立刻就暫停,至今不知道是為什么,手機端卻是正常的),所以還是多真機調試吧,都是淚。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM