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

2020-09-27

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

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

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

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

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