微信小程序API 音樂(lè)播放控制

wx.getBackgroundAudioPlayerState(OBJECT)

---

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

OBJECT參數(shù)說(shuō)明：

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

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

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

---

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

OBJECT參數(shù)說(shuō)明

參數(shù)	類(lèi)型	必填	說(shuō)明
dataUrl	String	是	音樂(lè)鏈接
title	String	否	音樂(lè)標(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)用成功、失敗都會(huì)執(zhí)行）

示例代碼

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

wx.pauseBackgroundAudio()

---

暫停播放音樂(lè)。

示例代碼

wx.pauseBackgroundAudio()

wx.seekBackgroundAudio(OBJECT)

---

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

OBJECT參數(shù)說(shuō)明

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

示例代碼

wx.seekBackgroundAudio({
    position: 30
})

wx.stopBackgroundAudio()

---

停止播放音樂(lè)。

示例代碼

wx.stopBackgroundAudio()

wx.onBackgroundAudioPlay(CALLBACK)

---

監(jiān)聽(tīng)音樂(lè)播放。

wx.onBackgroundAudioPause(CALLBACK)

---

監(jiān)聽(tīng)音樂(lè)暫停。

wx.onBackgroundAudioStop(CALLBACK)

---

監(jiān)聽(tīng)音樂(lè)停止。

bug & tip

1. bug:iOS6.3.30wx.seekBackgroundAudio 會(huì)有短暫延遲