1. 前往下载页面,下载最新版本,将下载的文件解压放在小程序utils文件夹中
2. 前往微信公众平台->开发->开发设置->服务器域名。添加以下request合法域名
3. 在小程序页面js文件中引用qqMusicTools.js,注意相对路径,这里演示的页面路径为"/pages/index/":
const musicTool = require("../../utils/QQMusicPlugin/qqMusicTools.js")
4. 搜索音乐接口searchMusic接受3个参数:page, number, keyword。分别表示搜索的页码,每页多少条搜索结果,搜索关键字。(使用PromiseJS语法)
musicTool.searchMusic(1, 10, "绿色").then(function(searchRes) {
console.log(searchRes)
})
搜索接果如下图:
5. 获取播放音乐链接接口playMusic接受1个参数:filename。表示要播放的音乐的文件名,文件名来自searchMusic结果中的"songmid"。(使用PeomiseJS语法)
musicTool.playMusic("0021rBlZ1gQiLy").then(function(playRes) {
console.log(playRes)
})
返回结果如下图:
6. 获取音乐专辑图片接口getAlbumImage接受1个参数:albumId。该参数来自searchMusic结果中的"albumId"。(使用Promise语法)(在v0.1版本中,搜索音乐接口已经集成了该接口,专辑图片字段名为"albumImg")
musicTool.getAlbumImage(6271293).then(function(res) {
console.log(res)
})
返回结果如下图:
7. 获取热门音乐榜Top100歌单接口getTopMusic不需要任何参数,直接调用即可获得返回结果。(使用Promise语法)
musicTool.getTopMusic().then(function(res) {
console.log(res)
})
返回结果如下图:
8. 随机推荐歌单接口radomRecommend不需要任何参数,直接调用即可获得返回结果。(使用Promise语法)
musicTool.randomRecommend().then(function(res) {
console.log(res)
})
返回结果如下图:
9. 播放音乐,这里使用BackgroundAudioManager演示
// 获取全局唯一的背景音乐管理器
const bgAudioManager = wx.getBackgroundAudioManager()
// 音乐标题
bgAudioManager.title = 'Music'
// 音乐歌手名
bgAudioManager.singer = 'Singer'
// 专辑封面图片
bgAudioManager.coverImgUrl = 'imgUrl'
// 音乐播放链接,设置后自动开始播放
bgAudioManager.src = playRes
10. 代码整合到一块,整个使用流程如下。(需要注意异步问题):
const bgAudioManager = wx.getBackgroundAudioManager();
// 搜索音乐
musicTool.searchMusic(1, 10, "绿色").then(function(searchRes) {
console.log(searchRes)
})
// 播放音乐
musicTool.playMusic("0021rBlZ1gQiLy").then(function(playRes) {
console.log(playRes)
bgAudioManager.title = 'Music'
bgAudioManager.src = playRes
})
// 获取音乐专辑图片
musicTool.getAlbumImage(6271293).then(function(res) {
console.log(res)
})
// 获取top100音乐
musicTool.getTopMusic().then(function(res) {
console.log(res)
})
// 随机推荐音乐
musicTool.randomRecommend().then(function(res) {
console.log(res)
})
11. 特别说明:
1.当要播放的音乐属于收费音乐时无法播放,具体表现为获取token返回值为空
2.注意js中的异步问题
3.微信小程序的BackgroundAudioManager存在部分链接无法播放的问题,因此建议使用InnerAudioContext,详细原因参见JabinGP的简书