微信小程序API音樂(lè)播放控制,獲取音樂(lè)播放狀態(tài)

2020-09-27

導(dǎo)讀：wx.getBackgroundAudioPlayerState(OBJECT) 獲取音樂(lè)播放狀態(tài)。 OBJECT參數(shù)說(shuō)明：參數(shù) 類型必填說(shuō)明 success Function 否接口調(diào)用成功的回調(diào)函數(shù) fail Function 否接口調(diào)用失敗的回調(diào)函數(shù) complete Funct...

wx.getBackgroundAudioPlayerState(OBJECT)

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

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

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

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

參數(shù)	類型	必填	說(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ù)	類型	必填	說(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)聽音樂(lè)播放。

wx.onBackgroundAudioPause(CALLBACK)

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

wx.onBackgroundAudioStop(CALLBACK)

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

bug & tip

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

更多微信小程序開發(fā)教程，可以關(guān)注hi小程序。

第二部分：如何開通一個(gè)小商店