新聞廣播 · ruyi.ai開發者文檔

### 3.5.2 新聞廣播 #### （1）功能說明新聞廣播功能主要是從有聲資源中挑選出來部分優質音頻新聞資源，通過頻道分為娛樂、科技、軍事、體育、八卦、社會、政治、財經、汽車、國際十類新聞，同時包括新聞聯播。可根據用戶請求返回相應類別，無明確類別默認返回新聞聯播。 #### (2) 接口說明 **請求方法** * POST **請求地址** * http://api.ruyi.ai/v1/message **請求參數說明** |參數名| 參數類型| 是否必須| 參數說明 |:---|:---|:---|:--- |q |String|是|自然語言表達，例如“我要聽娛樂新聞" |app_key|String|是| 應用開發者秘鑰，注冊開發者后臺賬號，建立虛擬助理后獲得 |user_id |String |是 |用戶唯一標識，便于支持個性化語義解析。建議開發者使用 UUID 字符，且不同用戶必須用不同的 user_id，防止意圖串。 #### (3) 返回說明 **返回參數說明** |名稱 |類型| 說明 |:---|:---|:--- |code |Integer | 返回代碼 |msg | String |返回代碼描述 |parameters|JSON Object |解析到的實體以及服務說明 |action|String|服務的接口名稱 |name| String|匹配的意圖名稱 |result | JSON Object| 接口返回內容 |outputs| Array| 服務輸出結果，微信端使用 type 類型為 wechat. 開頭的內容;硬件端收到所有內容，依據需求解析使用 **返回代碼說明** |返回代碼 |錯誤類型|說明 |:---|:---|:--- |0／200 |成功 |請求成功 |400 |無效請求 |某些必需參數缺失或參數值錯誤，詳見msg字段 |401 |未授權 |授權失敗，app_key缺失或錯誤 |403 |請求被禁止|有效請求，但服務拒絕響應，請聯系contact@ruyi.ai |408 |請求超時 |請求響應超時，一般響應時間設置為2000ms以內 |429 |短時間內大量訪問 |短時間內請求數過多 |500 |內部錯誤 |服務處理異常 |503 |服務不可用|服務異常或正在維護 #### （4）請求示例 **請求范例** _來個娛樂新聞_ _播放新聞_ **請求示例** （返回播放列表） * http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=來個娛樂新聞返回結果 ```json { "code": 0, "msg": "ok", "result": { "_text": "來個娛樂新聞", "msg_id": "eb7635ef-e6c7-4a4c-861c-404e9e3b3ae9", "intents": [{ "parameters": { "defaulttext": "我沒找到你要的聲音，換個別的聽吧", "聽的企圖": "來一段", "q": "娛樂", "service": "news_audio" }, "action": "sys.action.xmly/news", "name": "按類別點新聞", "result": { "id": "xmly:sound:52458882", "html_link": "http://www.ximalaya.com/sound/52458882", "source": "喜馬拉雅", "source_link": "http://www.ximalaya.com/", "sound_id": "52458882", "title": "兩個月餅的熱量相當于一個全家桶！", "media_url": "http://audio.xmcdn.com/group30/M01/09/CC/wKgJXlnLQG3TcEMUAEO9Cc5vVpw951.m4a", "cover_url": "http://fdfs.xmcdn.com/group30/M01/09/C9/wKgJXlnLQFfTXFrrAABjb0XNaBY701_mobile_small.jpg", "mp3_audio_url": "http://fdfs.xmcdn.com/group30/M04/09/F9/wKgJXlnLQfmBw12tACF2AJ_b5Mk553.mp3", "album": "不得不說", "album_id": "266944", "type": "sound", "tracks": { "id": 52458882, "kind": "track", "category_id": 1, "track_title": "兩個月餅的熱量相當于一個全家桶！", "track_tags": "話題,自媒體,頭條,娛樂,段子", "cover_url_small": "http://fdfs.xmcdn.com/group30/M01/09/C9/wKgJXlnLQFfTXFrrAABjb0XNaBY701_mobile_small.jpg", "cover_url_middle": "http://fdfs.xmcdn.com/group30/M01/09/C9/wKgJXlnLQFfTXFrrAABjb0XNaBY701_web_large.jpg", "cover_url_large": "http://fdfs.xmcdn.com/group30/M01/09/C9/wKgJXlnLQFfTXFrrAABjb0XNaBY701_mobile_large.jpg", "announcer": { "id": 10885843, "kind": "user", "nickname": "DJ小不", "avatar_url": "http://fdfs.xmcdn.com/group4/M04/E3/BE/wKgDs1QAFZejcwa_AAHbaCr1Dh4422_web_large.jpg", "is_verified": true }, "duration": 548, "play_count": 1442, "favorite_count": 13, "comment_count": 2, "can_download": true, "order_num": 0, "subordinated_album": { "id": 266944, "album_title": "不得不說", "cover_url_small": "http://fdfs.xmcdn.com/group21/M02/87/5B/wKgJLVikAm7z4-tOAAAtPWwzdo4886_mobile_small.jpg", "cover_url_middle": "http://fdfs.xmcdn.com/group21/M02/87/5B/wKgJLVikAm7z4-tOAAAtPWwzdo4886_mobile_meduim.jpg", "cover_url_large": "http://fdfs.xmcdn.com/group21/M02/87/5B/wKgJLVikAm7z4-tOAAAtPWwzdo4886_mobile_large.jpg" }, "source": 1, "updated_at": 1506504595000, "created_at": 1506492532000, "is_paid": false, "is_free": false, "is_trailer": false, "has_sample": false, "sample_duration": 0, "play_url_32": "http://fdfs.xmcdn.com/group30/M04/09/F9/wKgJXlnLQfmBw12tACF2AJ_b5Mk553.mp3", "play_size_32": 2192896, "play_url_64": "http://fdfs.xmcdn.com/group30/M01/09/CC/wKgJXlnLQG2jYSC8AELrtumq5GY802.mp3", "play_size_64": 4385718, "play_url_24_m4a": "http://audio.xmcdn.com/group30/M07/09/D1/wKgJXlnLQJ-jrf5wABnoqjvCwJg651.m4a", "play_size_24_m4a": 1697962, "play_url_64_m4a": "http://audio.xmcdn.com/group30/M01/09/CC/wKgJXlnLQG3TcEMUAEO9Cc5vVpw951.m4a", "play_size_64_m4a": 4439305, "play_size_amr": 0, "download_url": "http://download.xmcdn.com/group30/M06/2E/ED/wKgJWlnLQ_DSHWiUACF4p_hq5I8635.aac", "download_size": 2193575, "download_count": 0 }, "current_order_num": 0, "match_rule": "match", "track_list": [{ "track_title": "兩個月餅的熱量相當于一個全家桶！", "album_title": "不得不說", "cover_url": "http://fdfs.xmcdn.com/group30/M01/09/C9/wKgJXlnLQFfTXFrrAABjb0XNaBY701_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M01/09/CC/wKgJXlnLQG3TcEMUAEO9Cc5vVpw951.m4a", "announcer": "DJ小不", "track_id": 52458882, "order_num": 0, "album_id": "266944", "break_in_seconds": 0 }, { "track_title": "朱時茂帶來喜劇力作《胡楊的夏天》力邀陳佩斯潘長江眾多大咖加盟", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M00/30/87/wKgJWlnLU3jC68O3ABTmL9H25Mg337.m4a", "announcer": "飯愛豆", "track_id": 52465951, "order_num": 1, "album_id": "4619035" }, { "track_title": "我距離成為網紅就差一大筆整容費", "album_title": "不得不說", "cover_url": "http://fdfs.xmcdn.com/group32/M0A/00/1F/wKgJnFnEwXCBkBr_AAJtPIhLOKE219_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group31/M00/7D/EB/wKgJX1nEwZLSHGkWAD5EJwKV-h4926.m4a", "announcer": "DJ小不", "track_id": 51802179, "order_num": 2, "album_id": "266944" }, { "track_title": "我有的是時間，可是沒錢吶", "album_title": "不得不說", "cover_url": "http://fdfs.xmcdn.com/group33/M05/24/20/wKgJnVnIoNzzEYYXAAGpazErofw403_mobile_small.png", "media_url": "http://audio.xmcdn.com/group30/M03/CC/9D/wKgJXlnIoRWw1Ge5AEPBb_b-xfw264.m4a", "announcer": "DJ小不", "track_id": 52183684, "order_num": 1, "album_id": "266944" }, { "track_title": "《英倫對決》成龍嘗試突破自我現場親友團陣容豪華亮相", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M00/30/86/wKgJWlnLU3OTvcOyAAxRBd41NC8872.m4a", "announcer": "飯愛豆", "track_id": 52465950, "order_num": 2, "album_id": "4619035" }, { "track_title": "馮小剛攜《芳華》亮相廣州分享拍攝臺前幕后故事", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M0B/09/2C/wKgJWlnKALyiwF1wABO3Tf96OlU899.m4a", "announcer": "飯愛豆", "track_id": 52332196, "order_num": 3, "album_id": "4619035" }, { "track_title": "彭于晏angelababy有愛互懟被好友調侃快點結婚！", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M02/CF/88/wKgJXlnIu1zgOuN1AAdZux-z-9M584.m4a", "announcer": "飯愛豆", "track_id": 52195532, "order_num": 5, "album_id": "4619035" }, { "track_title": "新專輯《A.I. 愛》MV曝光音樂才子王力宏呼吁關注饒舌", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group33/M06/01/AD/wKgJnVnE1M7Rl1AaAA-KR-0ayPo890.m4a", "announcer": "飯愛豆", "track_id": 51812700, "order_num": 7, "album_id": "4619035" }, { "track_title": "《羞羞的鐵拳》上海點映好評爆棚艾倫馬麗首演情侶搞笑趣事多", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M0B/09/2B/wKgJWlnKALfzyZrPABBgriueEpw977.m4a", "announcer": "飯愛豆", "track_id": 52332195, "order_num": 4, "album_id": "4619035" }, { "track_title": "韓庚私下愛好拍照張亮服飾穿搭亮眼", "album_title": "飯愛豆", "cover_url": "http://fdfs.xmcdn.com/group13/M07/A1/A9/wKgDXVdzQgziumwWAACQ7QqxCFw709_mobile_small.jpg", "media_url": "http://audio.xmcdn.com/group30/M08/5A/38/wKgJWlnMtNqiDF9FAAmUk4XJX3Y750.m4a", "announcer": "飯愛豆", "track_id": 52609718, "order_num": 0, "album_id": "4619035" }], "text": "即將為您播放【兩個月餅的熱量相當于一個全家桶！】,來自專輯【不得不說】" }, "outputs": [{ "type": "wechat.music", "property": { "title": "兩個月餅的熱量相當于一個全家桶！", "description": "不得不說", "music_url": "http://audio.xmcdn.com/group30/M01/09/CC/wKgJXlnLQG3TcEMUAEO9Cc5vVpw951.m4a" } }, { "type": "wechat.text", "property": { "text": "即將為您播放娛樂新聞" } }, { "type": "dialog", "property": { "text": "即將為您播放【兩個月餅的熱量相當于一個全家桶！】,來自專輯【不得不說】", "emotion": "like" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "d7d3579e-bb65-4120-b1a3-f9d4ff9a90f4", "id": "3b930137-0a83-4bd8-83d0-8e49769bdd7c" }], "meta_process_milliseconds": 229 } } ``` **詳細參數說明** |名稱 |類型| 說明 |:---|:---|:--- |service| String |服務名稱 |html_link| String |網頁鏈接 |source|String|來源 |source_link|String|來源鏈接 |sound_id|String|音頻ID |title|String|題目標題 |media_url|String|音頻鏈接 |cover_url|String|封面鏈接 |mp3_audio_url|String|mp3鏈接 |album|String|專輯名稱 |album_id|String|專輯ID |tracks|Array|聲音列表 |category_id|String|類別ID |track_title|String|聲音標題 |track_tags|String|聲音標簽 |track_intro|String|聲音簡介 |track_id|String|聲音ID |cover_url_small|String|分類封面小圖| |cover_url_middle|String|分類封面中圖| |cover_url_large|String| 分類封面大圖| |announcer|String|主播信息 |play_count|Integer|專輯播放次數 |favorite_count|Integer|專輯收藏次數 |comment_count|Integer|專輯評論次數 |download_count|Integer|專輯下載次數 |can_download|Boolean|可否下載，true 則為可下載 |download_url|String|下載鏈接 |download_size|Integer|聲音下載大小 |updated_at|String|專輯更新時間 |created_at|String|專輯創建時間 |order_num|String|排序值,值越小排序越在前 |current_order_num|String|當前排序值 |track_list|Array|聲音列表