作者:2024欧洲杯投注入口小徐 发布时间:2024-08-28 浏览:20185 赞(1950) 收藏 评论(0)
请求地址: http://{BASE_URL}/xwcloudapi/text_to_skills
请求方式: post
请求参数包含三部分:请求query文本、请求接口基础参数、当前播放状态state_info。请求query文本示例如上表所示;请求接口基础参数相关描述见请求接口基础参数说明章节;
技能请求必须携带state_info。对于通用控制的请求,需要依赖state_info.cur_res_info.skill_name进行判断是那个技能的通用控制,比如下一首,依赖state_info.cur_res_info.skill_name进行判断是音乐技能的下一首还是FM技能的下一首。 虽然state_info字段只有通用控制("收藏"、"取消收藏"、"播放收藏"、"下一首","上一首","暂停","继续播放","重播","单曲循环","顺序播放","循环播放","随机播放","快进","快退","音量大一点","音量小一点","静音","取消静音")的请求使用,但是在访问技能请求接口之前,无法确定是否为通用控制的请求,所以必须带上当前设备的播放状态state_info相关参数,尽量把可以获取到的参数带上,尤其是cur_res_info中的参数,避免通用控制不生效。
对于state_info,必须携带state_info.client_addr字段。由于音乐资源地区版权问题,Q音要求请求需要携带客户端ip,用于判断客户所在地区。如果无法获取用户客户端ip,请与小微商务进行提前沟通。state_info 的字段组成如下:
field name | field type | required | desc |
---|---|---|---|
cur_res_info | json object | No | 当前播放资源信息,详细信息见下文 |
location_info | json object | No | 位置信息,详细信息见下文 |
gps_info | json object | No | GPS信息,详细信息见下文 |
client_addr | string | Yes | 客户端ip地址 |
play_mode | int | No | 0:顺序播放 1:列表循环 2:随机不循环 3:随机循环 4:单曲循环 |
play_state | int | No | 1:歌曲开始 2:暂停 3:歌曲结束 4:歌单结束 11:没播完切歌 |
curent_time | int | No | 上报时间 |
其中cur_res_info中字段如下
field name | field type | required | desc |
---|---|---|---|
skill_name | string | No | 技能名称,请求到资源时会传回技能名称 |
res_id | string | No | 资源id |
res_name | string | No | 资源名,可以使用music_name字段 |
res_singer | string | No | 演唱者 |
content | string | No | 资源url |
time_offset_ms | int | No | 播放时间偏移 |
其中location_info 中字段如下:
field name | field type | required | desc |
---|---|---|---|
contry | string | NO | 国家 |
province | string | NO | 省份 |
city | string | NO | 城市 |
street | string | NO | 街道 |
community | string | NO | 社区 |
其中gps_info 中字段如下:
field name | field type | required | desc |
---|---|---|---|
altitude | double | NO | 海拔高度 |
latitude | double | NO | 纬度 |
longitude | double | NO | 经度 |
speed | double | NO | 速度 |
standard_gps_time | int | NO | 标准gps时间 |
2024欧洲杯投注入口项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,2024欧洲杯投注入口合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注2024欧洲杯投注入口官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!