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

wx.getBackgroundAudioPlayerState(OBJECT)

---

獲取音樂播放狀態(tài)。

OBJECT參數(shù)說明：

參數(shù)	類型	必填	說明
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行）

success返回參數(shù)說明：

參數(shù)	說明
duration	選定音頻的長度（單位：s），只有在當(dāng)前有音樂播放時(shí)返回
currentPosition	選定音頻的播放位置（單位：s），只有在當(dāng)前有音樂播放時(shí)返回
status	播放狀態(tài)（2：沒有音樂在播放，1：播放中，0：暫停中）
downloadPercent	音頻的下載進(jìn)度（整數(shù)，80 代表 80%），只有在當(dāng)前有音樂播放時(shí)返回
dataUrl	歌曲數(shù)據(jù)鏈接，只有在當(dāng)前有音樂播放時(shí)返回

示例代碼：

wx.getBackgroundAudioPlayerState({
    success:function(res){
        var status = res.status
        var dataUrl = res.dataUrl
        var currentPosition = res.currentPosition
        var duration = res.duration
        var downloadPercent = res.downloadPercent
    }
})

wx.playBackgroundAudio(OBJECT)

---

使用后臺播放器播放音樂，對于微信客戶端來說，只能同時(shí)有一個(gè)后臺音樂在播放。當(dāng)用戶離開小程序后，音樂將暫停播放；當(dāng)用戶點(diǎn)擊“顯示在聊天頂部”時(shí)，音樂不會暫停播放；當(dāng)用戶在其他小程序占用了音樂播放器，原有小程序內(nèi)的音樂將停止播放。

OBJECT參數(shù)說明

參數(shù)	類型	必填	說明
dataUrl	String	是	音樂鏈接
title	String	否	音樂標(biāo)題
coverImgUrl	String	否	封面URL
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行）

示例代碼

wx.playBackgroundAudio({
    dataUrl: '',
    title: '',
    coverImgUrl: ''
})

wx.pauseBackgroundAudio()

---

暫停播放音樂。

示例代碼

wx.pauseBackgroundAudio()

wx.seekBackgroundAudio(OBJECT)

---

控制音樂播放進(jìn)度。

OBJECT參數(shù)說明

參數(shù)	類型	必填	說明
position	Number	是	音樂位置，單位：秒
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行）

示例代碼

wx.seekBackgroundAudio({
    position: 30
})

wx.stopBackgroundAudio()

---

停止播放音樂。

示例代碼

wx.stopBackgroundAudio()

wx.onBackgroundAudioPlay(CALLBACK)

---

監(jiān)聽音樂播放。

wx.onBackgroundAudioPause(CALLBACK)

---

監(jiān)聽音樂暫停。

wx.onBackgroundAudioStop(CALLBACK)

---

監(jiān)聽音樂停止。

bug & tip

1. bug:iOS6.3.30wx.seekBackgroundAudio 會有短暫延遲