微信小程序开发 专题
专题目录
您的位置:微信小程序开发 > 微信小程序开发专题 > 微信小程序API 音乐播放控制
微信小程序API 音乐播放控制
作者:--    发布时间:2019-11-20

wx.getbackgroundaudioplayerstate(object)


获取音乐播放状态。

object参数说明:

参数类型必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数 说明
duration 选定音频的长度(单位:s),只有在当前有音乐播放时返回
currentposition 选定音频的播放位置(单位:s),只有在当前有音乐播放时返回
status 播放状态(2:没有音乐在播放,1:播放中,0:暂停中)
downloadpercent 音频的下载进度(整数,80 代表 80%),只有在当前有音乐播放时返回
dataurl 歌曲数据链接,只有在当前有音乐播放时返回

示例代码:

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)


使用后台播放器播放音乐,对于微信客户端来说,只能同时有一个后台音乐在播放。当用户离开小程序后,音乐将暂停播放;当用户点击“显示在聊天顶部”时,音乐不会暂停播放;当用户在其他小程序占用了音乐播放器,原有小程序内的音乐将停止播放。

object参数说明

参数类型必填说明
dataurlstring音乐链接
titlestring音乐标题
coverimgurlstring封面url
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.playbackgroundaudio({
    dataurl: '',
    title: '',
    coverimgurl: ''
})

wx.pausebackgroundaudio()


暂停播放音乐。

示例代码

wx.pausebackgroundaudio()

wx.seekbackgroundaudio(object)


控制音乐播放进度。

object参数说明

参数类型必填说明
positionnumber音乐位置,单位:秒
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.seekbackgroundaudio({
    position: 30
})

wx.stopbackgroundaudio()


停止播放音乐。

示例代码

wx.stopbackgroundaudio()

wx.onbackgroundaudioplay(callback)


监听音乐播放。

wx.onbackgroundaudiopause(callback)


监听音乐暂停。

wx.onbackgroundaudiostop(callback)


监听音乐停止。


bug & tip

  1. bug:ios6.3.30wx.seekbackgroundaudio 会有短暂延迟

网站声明:
本站部分内容来自网络,如您发现本站内容
侵害到您的利益,请联系本站管理员处理。
联系站长
373515719@qq.com
关于本站:
编程参考手册