QQ音乐api的使用

在移动端上虽然QQ音乐没有提供native sdk，但是可以通过http请求的方式使用QQ音乐的能力，封装一下就能实现一个简单的音乐播放器。

一、音乐搜索接口

Method：

GET

URL：

https://c.y.qq.com/soso/fcgi-bin/client_search_cp?aggr=1&cr=1&flag_qc=0&p=1&n=30&w=简单爱

参数：

• p：页数，从1开始
• n：每一页显示的条数
• w：搜索关键字

通过p和n参数，就可以实现分页请求加载了。可以在浏览器中打开链接查看返回的数据格式。

二、其他接口

1. 最新音乐排行榜top100

• Method：GET
• URL：

https://c.y.qq.com/v8/fcg-bin/fcg_v8_toplist_cp.fcg?g_tk=5381&uin=0&format=json&inCharset=utf-8&outCharset=utf-8¬ice=0&platform=h5&needNewCode=1&tpl=3&page=detail&type=top&topid=27&_=1519963122923

2. 随机推荐

• Method：GET
• URL：

https://c.y.qq.com/v8/fcg-bin/fcg_v8_toplist_cp.fcg?g_tk=5381&uin=0&format=json&inCharset=utf-8&outCharset=utf-8¬ice=0&platform=h5&needNewCode=1&tpl=3&page=detail&type=top&topid=36&_=1520777874472

三、数据格式

以搜索结果的数据格式为例，curPage即当前页数，totalnum即总数。list中即本次请求的30条歌曲的数据，如果请求的位移超过了totalnum，list中返回0条。
然后主要看下list下的歌曲信息应该如何使用，一个简单的播放器显示会有专辑名称、封面、歌曲名称、歌手名称等：

1. 歌曲名称

songname

2. 歌手名称

singer字段，列表结构，其中会多个歌手的信息

3. 专辑名称

albumname

4. 专辑封面

封面图片url要使用albumid字段拼接生成，格式：

"http://imgcache.qq.com/music/photo/album_300/%i/300_albumpic_%i_0.jpg", albumid%100, albumid

比如albumid=8217，封面地址就是http://imgcache.qq.com/music/photo/album_300/17/300_albumpic_8217_0.jpg，可以在浏览器中打开验证。

5. 播放链接

播放链接并不是一个永久的地址，每次需要动态获取一个token，然后再生成播放链接。这个token是用来验证链接的有效性的，会包含时效等信息。用过阿里云oss服务的同学应该知道，图片链接会包含一个鉴权token，只可在有效时间内使用，能防止盗链，这个也是类似的。

获取token

Method：GET
URL：

https://c.y.qq.com/base/fcgi-bin/fcg_music_express_mobile3.fcg?format=json205361747&platform=yqq&cid=205361747&songmid=003lghpv0jfFXG&filename=C400003lghpv0jfFXG.m4a&guid=126548448

songmid可以从歌曲信息中取到，filename根据songmid生成。比如，songmid是003lghpv0jfFXG，则filename就是前缀加上C400，后缀加上.m4a，即C400003lghpv0jfFXG.m4a。其他字段format、platform、cid、guid可以写死，但都是必须的。

请求到的结果中可以看到expiration为80400（秒），表示有效时长大约22.3小时。vkey字段就是我们接下来拼接播放地址要使用的。

拼接播放地址

http://ws.stream.qqmusic.qq.com/C400003lghpv0jfFXG.m4a?fromtag=0&guid=126548448&vkey=D661E5DF19B8FEB2FBFC554276746AC608AE98B0F30595B3B3BAD5C1C89ECCDD7BE599E306F786621856D22D6BD6B96F5DD344CF3814DB71

url的path就是上文中用到的filename。参数中的几个字段都是必须的：guid要和请求token时使用的guid保持一致，vkey即token中的vkey字段，fromtag随意指定一个整数，可以写死为0。
可以将你拼接好的地址复制到浏览器中验证是否能正常播放。

注意：
1.如果没有fromtag字段，链接可以在浏览器中播放，但在移动端上播放不了。
2.这种方法大部分歌曲能获取到播放链接，但少量歌曲获取不到vkey，如排行榜top100中的带“纯享版”歌曲，大家可以试一下。

获取不到vkey的情况

四、应用

最后安利一个APP：小时光（AppStore搜索“小时光SmartTime”），一款时光轴风格的日记本，其中在日记中添加音乐使用了该功能，欢迎使用和关注~