注冊(cè)

微信小程序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)

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


獲取音樂(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

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

 

更多微信小程序開發(fā)教程,可以關(guān)注hi小程序。
重磅推薦:小程序開店目錄

第一部分:小商店是什么

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

第三部分:如何登錄小商店

第四部分:開店任務(wù)常見問(wèn)題

第五部分:小商店可以賣什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結(jié)算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開發(fā)