詳細的指令說明請參照[《靈聚SDK指令說明文檔》](http://doc.lingju.ai/@ljsdk/android_sdk)。
關于獲取歌曲播放鏈接的說明:當聊天應答接口輸入為播放歌曲的意圖時,靈聚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均能取得有效的鏈接。
**聲明:本公司僅提供音頻鏈接的獲取方法用于播放演示,不提供任何音頻作品的版權許可,請勿將該播放方式用于任何商業用途,如引起任何版權糾紛一概與我司無關。**