作者:重庆互联网小徐 发布时间:2024-06-05 浏览:20420 赞(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年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!