扫码查看手机端
请求参数:对于请求音乐资源接口,由于音乐资源地区版权问题,Q音要求请求需要携带客户端ip,判断客户所在地区。对应请求参数需要增加用户客户端ip client_addr字段,如果无法获取用户客户端ip,请与小微商务进行提前沟通。
在音乐的各个接口中,字段返回会有细微的差别,但是其中的大部分的接口字段都会重复出现,为了避免重复介绍相关的字段说明,再此统一进行说明,可以统一在此进行查询
该接口进行解绑音乐登陆态,拉起QQ音乐App、小程序授权 扫码注册音乐登录态两种方式都使用该接口进行解绑。
小微目前支持QQ、微信、Q音三种账号扫码注册音乐的登陆态,QQ和Q音账号注册的登陆态有效期90天,微信账号注册的登陆态有效期30天。扫码注册流程:1、通过获取二维码接口获取二维码数据;2、将获取到的二维码展现给用户,用户扫码确认授权3、调用方后台需要使用查询扫码注册授权状态接口,确定最终授权是否成功。
资源获取接口可以获取音乐、FM、天气三种资源,目的是使有屏设备更容易获取到相关资源,进行展示。
设置闹钟的操作方式:1增加 2修改 3删除 4.修改闹钟类型
content字段为请求返回的内容,百科、股票、闲聊、天气skill技能名称可取Baike、Chat、Stock、Weather。
不同的技能返回的资源字段会有差别。
不同的技能返回的资源字段会有差别。音乐技能与FM技能返回的数据如下所示。
返回结果包含四部分:code错误码提示、resources获取相关资源、skill技能名称、msg错误提示。
目前推荐使用方式二:获取安全凭据接口获取凭证,所以请求示例都以此方式进行描述。如果仍然使用方式一获取凭证,请求示例中的pid、auth、query_id去掉,增加base_info字段,base_info相关描述详见基础说明章节。所有技能的请求格式一致,各技能对应的query不同
请求参数包含三部分:请求query文本、请求接口基础参数、当前播放状态state_info。
所有的文本请求都可以走技能请求接口,但是相关的技能权限需要在官网进行申请,当前支持技能:音乐、FM、新闻、百科、闲聊、闹钟、天气、股票。
目前提供音乐、百科、闲聊、股票、FM、天气、股票、闹钟的语义的解析。
该语音请求中语音数据的长度;对于speex等类型的压缩语音,是指压缩前原始语音的长度;需要跟解压后语音的长度一致;
关于请求中的 SN和uid 可能会牵扯一些业务方的核心数据问题,本质上小微这边不对SN和UID进行判别和是识别的,只是为了区分调用的一个设备和一个用户,业务方也可以在自己后台做个1对1映射,但是一定要保证一个用户可以映射到一个uid上,一个设备可以映射到一个sn上
为了方便使用和理解。我们对所有的接口做了一些整体的说明,除非特别标注。所有接口都遵从此规范。
为了保证接口调用的安全性,腾讯小微对接口调用做了一些调用限制,主要从2个方面来实现的。分别是IP访问白名单、接口鉴权。
为了更加方便用户使用小微技能,小微提供云端API的接入方式。用户请求云端Http接口,即可方便接入小微技能。目前小微云端API提供基础鉴权、asr、语义解析、技能请求、获取资源接口。
如果希望通过云API形式接入腾讯小微的语音助手,需要提供详细信息,并发送邮件到小微商务:xiaowei_bd@tencent.com
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!
023-81623110 / 023-62897001 / 023-62891977
售前客服 / 售后客服 / 技术支持
admin@023net.net