重庆互联网,19年企业互联网解决经验,专业网站开发、移动端开发、微信端开发、小程序开发!
重庆网络推广公司

腾讯小微(38)— linux中小微业务层接口函数(二)

作者:重庆互联网小徐 发布时间:2024-06-05 浏览:19831 赞(1950 收藏 评论(0)

通用请求

int xiaowei_request_cmd(char* voice_id, const char* cmd, const char* sub_cmd,  const char* param, XIAOWEI_ON_REQUEST_CMD_CALLBACK callback);

您可以通过通用请求接口来获取资源或触发事件,通过这个接口的请求会有单独的response callback,需要在每次调用时传入,param为命令参数的json。如果传入的callback为null,则会在通用的on_request_callback中回调。下面对于支持的命令作说明:

为了便于说明,这里抛出XIAOWEI_ON_REQUEST_CMD_CALLBACK里面的jsonData通用结构,它的结构和XIAOWEI_PARAM_RESPONSE很相似,或者说是它的json展现。

//通用响应json结构
voiceId: XXX
error: 0
json: 
     {
         "context": {
             "id": "",
             "silent_timeout": 500,
             "speak_timeout": 0
         },
         "skill_info": {
             "id": "xx",
             "name": "音乐",
             "type": 0
         },
         "control_id": 0,
         "control_value": "",
         "has_history_playlist": false,
         "has_more_playlist": false,
         "play_behavior": 1,
         "resource_list_type": 0,
         "response_data":"data",
         "resource_groups": [{
             "resources": [{
                 "content": "url",
                 "extend_buffer": "info",
                 "format": 0,
                 "id": "id",
                 "offset": 0,
                 "play_count": -1
             }],
             "resources_size": 1
         }]
     }

除非特别说明,否则下面的响应均指上面这个json中的response_data字段。

预拉取

用于获取更多播放资源(音乐、FM、新闻),一般在当前资源快要播放完毕的时候调用此接口获取更多。此接口也可用于拉取历史列表。(列表第一首向上拉就是拉历史)

Request

cmd: "PLAY_RESOURCE"
subCmd: get_more
params: 
{
     "skill_info": {
         "id": "例如:音乐的skillid",
         "name": "例如:音乐"
     },
     "play_id": "xxx",
     "is_up": false
}	

Response格式参照[通用响应结构]。

查资源详情

一般就是查询音乐的歌词。

Request

cmd: PLAY_RESOURCE
subCmd: get_detail
params:
{
     "skill_info": {
         "id": "例如:音乐的skillid",
         "name": "例如:音乐"
     },
     "play_ids": ["id0", "id1"]
}	

Response格式参照[通用响应结构]。

刷新播放资源

用于切换音乐品质或 url 过期需要刷新时调用,QQ音乐下发的URL只确保4小时有效,如果超过4小时,建议刷新一下。

Request

cmd: PLAY_RESOURCE
subCmd: refresh
params:
{
     "skill_info": {
         "id": "例如:音乐的skillid",
         "name": "例如:音乐"
     },
     "play_ids": ["id0", "id1"]
}	

Response格式参照[通用响应结构]。

获取收藏列表

Request

cmd: PLAY_RESOURCE
subCmd: get_favorite_list
params:
{
     "skill_info": {
         "id": "...",
         "name": "例如:音乐"
     }
}	

Response格式参照[通用响应结构]。

收藏及取消收藏

Request

cmd: PLAY_RESOURCE
subCmd: set_favorite
params:
{
     "skill_info": {
         "id": "...",
         "name": "例如:音乐"
     },
	  "favorite":/*bool, false表示取消收藏,true表示收藏*/,
	  "play_id":"string id"
}	

Response格式参照[通用响应结构],可能会有一句“收藏成功”的notify TTS。


重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!

关注重庆互联网官方公众号,即可获取粉丝专享福利!

重庆互联网公众号二维码.jpg

网友留言评论
我要评论
评论

欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!

  • 赞(0
    踩(0
重庆网站定制建设
  • 重庆网站建设平台
  • 重庆网站优化公司
  • 重庆网络推广公司哪家好
  • 重庆APP制作公司
版权所有 ©2004-2024 重庆市渝中区圣灵科技信息有限公司 渝ICP备16004600号-14 渝公网安备50010802001420号 电子营业执照
重庆公众号制作哪家好
二维码
联系客服 重庆商城网站建设