作者:重庆互联网小徐 发布时间:2024-09-10 浏览:20395 赞(1950) 收藏 评论(0)
资源获取接口可以获取音乐、FM、天气三种资源,目的是使有屏设备更容易获取到相关资源,进行展示。
如果用户需要使用音乐相关的能力,可以使用音乐的相关接口。音乐技能接口主要分三类,1. 用户登录态管理相关的,主要存储用户登录态相关的。2。 资源获取类接口,这部分主要提供用户获取资源的,包括在设备上展示各种歌曲资源,歌单推荐,类型音乐推荐和搜索等相关接口 3. 语义点播类接口 支持传入用户请求文本或语音数据直接输出需要播放的歌曲接口。
由于QQ音乐规定手机端QQ音乐的相关音乐资源播放必须使用QQ音乐客户端,**因此使用本章节的所有接口获取的资源仅限在智能音箱设备上播放,**手机上仅能做歌曲信息介绍等产品使用场景,不能进行音乐资源的播放。
用户如果需要使用小微音乐技能除音乐随心听的相关功能,必须先在平台注册用户的登录态,这样才可以使用音乐的相关能力。注册音乐的登录态,当前有两种方式:
1.拉起QQ音乐App、小程序授权:拉起QQ音乐客户端、小程序,相关流程参考Q音授权登录服务,获取到用户音乐登录态之后,将音乐登录态数据存储到小微。(拉起QQ音乐参数申请需要联系商务申请:xiaowei_bd@tencent.com)
扫码注册音乐登录态:带屏智能设备端获取二维码,支持微信、QQ 、QQ音乐APP三种方式,扫码注册登录态到小微。
**注意:**1、两种注册登陆态方式选择一种即可,推荐第二种扫码注册音乐登录态。 2、两种登录态的注册都是绑定在用户身份。
两种方式的主要区别: 第一种需要调用方调用Q音开放接口获取音乐登陆态,而第二种扫码注册音乐登录态调用方不用自行获取音乐登陆态,用户直接扫描调用方从小微获取的二维码即可。
请求地址: https://{BASE_URL}/xwcloudapi/register_info?info_type=####
info_type=music_login_info
请求参数:
由于登录态是跟随用户的,因此请求参数中base_info 中的sn 没有起作用
field name | field type | required | Desc |
---|---|---|---|
login_type | Int | Yes | 取值0, 1, 2。 0: QQ账号登录 1:微信账号登录。2: 拉起QQ音乐app登录,或者qq音乐app扫码登录 |
app_id | String | Yes | 获取到的appid 属于qq音乐分配的,联系我们商务获取 |
open_id | String | Yes | 登录态open_id |
access_token | String | Yes | 登录态access_token |
请求接口基础参数 | Yse | 详见请求接口基础参数说明章节 |
请求参数示例
{ "login_type": 2, // 拉起QQ音乐app登录,或者qq音乐app扫码登录 "app_id":"1106062274", "open_id": "E4B834AF95D96973A1EAD747659517D4", "access_token": "2F548D28CA347D706ED168775992FC6E", "请求接口基础参数":{xxxxx} // 详见**请求接口基础参数说明**章节}
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!