3.音频指令示例
详细的指令说明请参照<a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/cPJW93OK">《Chatbot接口指令说明文档》</a>
关于获取歌曲播放链接的说明：当聊天应答接口输入为播放歌曲的意图时，灵聚AI会返回查询歌曲的指令及播放所查询歌曲的指令，同时会附带灵聚提供的音频资源，如：
播放歌曲返回的JSON示例：
~~~
输入：播放张学友的听海
输出：{"status":0,answer:****
"{"rtext":"好的", "synthetise":"", "ttext":"","outc":0,"motions":\[\]
"actions":\[
{"action":"QUERY",
"target":{ "id":100,
"name":"听海",
"singer":\["张学友"\],
"type":"歌曲"}},
{"action":"SET",
"target":{
"id":300,
"origin":"AUTO",
"type":"AUDIO",
"object":\[{
"id":"100",
"name":"听海",
"singer":\["张学友"\],
"composer":"涂惠源",
"musicId":"xxx",
"album":"活出生命Live演唱会",
"lyricist":"林秋离"}\],
"control":"PLAY" }
}\]}"}
~~~
语义解释：
音频播放包括音频资源的查询，播放器播放音频的步骤，因此音频播放的动作目标对象包括音频对象和播放器对象，示例以两者的组合形式给出，指令描述如下：
1\.查询（QUERY）音频对象（id=100）：歌名=听海，歌手=张学友，
2\.设置播放器（SET） 播放器对象（id=300）,播放来源AUTO,即AI给出的音频实体(object)，播放状态为PLAY。（播放器对象详见5.3节）
上例中的音频实体object 附带了musicId，开发者可根据musicId的值去酷我的网站获取对应的播放链接，获取方法：
HTTP get请求：
[http://antiserver.kuwo.cn/anti.s?response=url&format=aac%7Cmp3&type=convert\_url&rid=musicId&qq-pf-to=pcqq.c2c](http://antiserver.kuwo.cn/anti.s?response=url&format=aac%7Cmp3&type=convert_url&rid=musicId&qq-pf-to=pcqq.c2c)
请注意将以上链接的musicId替换成指令中提供的musicId。此外还需要判断返回的链接是否有效（若无效可重试若干次），不保证所有musicId均能取得有效的链接。
**声明：本公司仅提供音频链接的获取方法用于播放演示，不提供任何音频作品的版权许可，请勿将该播放方式用于任何商业用途，如引起任何版权纠纷一概与我司无关。**