### 3.5.5 兒童聽聽
#### （1） 功能說明
兒童聽聽技能插件，支持點播兒歌、故事、國學、課文、散文、詩詞、相聲、小品、笑話、段子、戲曲、曲藝，返回最多包含10首單曲的播放列表。目前兒童聽聽技能的數據主要來自工程師爸爸、喜馬拉雅FM和蜻蜓FM，返回url包含mp3和m4a格式，客戶可根據需求解析特定格式的url。
#### （2） 接口說明
**請求方法**
* POST
**請求地址**
* [http://api.ruyi.ai/v1/message](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） 請求示例
**請求范例**
_放兒歌_
_我要聽相聲_
_放一首兔小貝兒歌_
_我要聽蟲兒飛_
_我想聽兔小貝兒歌的蟲兒飛_
_讀個散文_
_唱首搖籃曲_
**請求示例**
(成功，返回符合結果的單曲，和該單曲所在專輯最多10個曲目的播放列表）
* http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=播放故事
返回結果
```
{
"_text": "播放故事",
"msg_id": "5b5d07ba-03ee-4175-8e03-e58a7ddb77d7",
"intents": [{
"parameters": {
"tag1": "故事",
"service": "kids_audio"
},
"action": "標簽點播",
"name": "標簽點播",
"result": {
"code": 200,
"response": {
"code": 0,
"msg": "成功",
"result": {
"track_list": [{
"name": "蘋果姑娘",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADcGNFA0DTw=",
"durationInSeconds": 0,
"position": 0,
"inAlbum": {
"name": "蘋果姑娘",
"identifier": "ADcGNFA0DTw=",
"image": "http://img.idaddy.cn/b/9/bka1kr5l.jpg",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/fedd/haizhi0000000001/201709130000/0/YS8wL2JrYTFrcjVsLmF1ZGlv.mp3",
"encodingFormat": "mp3"
}]
}]
},
{
"name": "捍衛家園的大戰",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADIGMFAwDTI=",
"durationInSeconds": 0,
"position": 0,
"inAlbum": {
"name": "捍衛家園的大戰",
"identifier": "ADIGMFAwDTI=",
"image": "http://img.idaddy.cn/b/7/90w41fla.jpg",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/02b7/haizhi0000000001/201709130000/0/YTY0LzcvaGd2aTltanguYXVkaW8=.mp3",
"encodingFormat": "mp3"
}]
}]
},
{
"name": "解開圓周之謎的科學家祖沖之",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADYGMFAyDTQ=",
"durationInSeconds": 0,
"position": 0,
"inAlbum": {
"name": "解開圓周之謎的科學家祖沖之",
"identifier": "ADYGMFAyDTQ=",
"image": "http://img.idaddy.cn/b/1/630pcgu4.jpg",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/c552/haizhi0000000001/201709130000/0/YS8xL3loanFqd3ppLmF1ZGlv.mp3",
"encodingFormat": "mp3"
}]
}]
}
],
"msg": "ok"
}
},
"text": "即將播放【蘋果姑娘】",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "即將播放【蘋果姑娘】"
}
},
{
"type": "dialog",
"property": {
"text": "即將播放【蘋果姑娘】",
"emotion": "calm"
}
}
],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"skill_id": "5e3b3bd9-52b7-4039-b5eb-5f1223f80b67",
"id": "3a6c0f3c-f895-4661-bd9c-f229cc19915c"
}],
"meta_process_milliseconds": 488
}
```
**請求示例**
(失敗，返回推薦最多10個曲目的播放列表，同時結果中以字段code 404表示未搜索到符合條件的資源）
* http://api.ruyi.ai/ruyi-api/v1/message?app\_key=APP\_KEY&user\_id=user0&q=我要聽相聲小紅帽
返回結果
```
{
"_text": "我要聽相聲小紅帽",
"msg_id": "a8405059-ac10-4d65-888c-5c1244a4b1db",
"intents": [{
"parameters": {
"tag1": "相聲",
"trackName": "小紅帽",
"statedIn": "www.idaddy.cn",
"service": "kids_audio"
},
"action": "標簽點播",
"name": "標簽+單曲",
"result": {
"code": 200,
"response": {
"code": 0,
"msg": "成功",
"result": {
"track_list": [{
"name": "3、小紅帽",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADEGMFAwDTZRbg==",
"durationInSeconds": 0,
"position": 3,
"inAlbum": {
"name": "吳頌今經典兒歌1：幼兒萌曲",
"identifier": "ADwGNlA1DTE=",
"image": "http://img.idaddy.cn/b/4/cy4hivbv.png",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/9604/haizhi0000000001/201709130000/1/YS8wLzh4NGt3N2J4LmF1ZGlv.mp3",
"encodingFormat": "mp3"
}]
}]
},
{
"name": "1、鈴兒響叮當",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADEGMFAwDTZRYA==",
"durationInSeconds": 0,
"position": 1,
"inAlbum": {
"name": "吳頌今經典兒歌1：幼兒萌曲",
"identifier": "ADwGNlA1DTE=",
"image": "http://img.idaddy.cn/b/4/cy4hivbv.png",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/0dd3/haizhi0000000001/201709130000/0_adidaddy/YS8wL3dkaGZtZWZjLmF1ZGlv.mp3",
"encodingFormat": "mp3"
}]
}]
},
{
"name": "2、機器貓",
"@type": [
"MusicRecording",
"CreativeWork",
"Thing"
],
"mergedFrom": [{
"identifier": "ADEGMFAwDTZRbw==",
"durationInSeconds": 0,
"position": 2,
"inAlbum": {
"name": "吳頌今經典兒歌1：幼兒萌曲",
"identifier": "ADwGNlA1DTE=",
"image": "http://img.idaddy.cn/b/4/cy4hivbv.png",
"@type": [
"MusicAlbum",
"CreativeWork",
"Thing"
]
},
"audio": [{
"contentUrl": "http://cdn.open.idaddy.cn/apsmp3/e481/haizhi0000000001/201709130000/1/YS8wLzhseWpqNGt2LmF1ZGlv.mp3",
"encodingFormat": "mp3"
}]
}]
}
],
"msg": "未搜索到相應結果",
"code": 404
}
},
"text": "未找到相應資源，為您推薦【3、小紅帽】",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "未找到相應資源，為您推薦【3、小紅帽】"
}
},
{
"type": "dialog",
"property": {
"text": "未找到相應資源，為您推薦【3、小紅帽】",
"emotion": "happy"
}
}
],
"score": "0.9999541586510267",
"scoreColor": "c4",
"is_match": 1,
"skill_id": "5e3b3bd9-52b7-4039-b5eb-5f1223f80b67",
"id": "45c1b182-69fd-4bb4-8e3c-a36c46af56d4"
}],
"meta_process_milliseconds": 752
}
```
**詳細參數說明**
| 名稱 | 類型 | 說明 |
| :--- | :--- | :--- |
| service | String | 服務名稱 |
|tag|String | 標簽名，包含兒歌、故事、國學、詩詞等，多個標簽用后綴1，2...數字區分 |
|trackName|String |識別到的音頻名稱|
|statedIn|String |數據來源網站|
|track_list|String |返回的音頻列表|
|name|String |音頻名稱|
|@type|String |實體類型|
|identifier|String|數據來源網站ID|
|durationInSeconds|String|音頻時長|
|position|String|音頻在專輯中的位置|
|inAlbum|String|音頻所在專輯|
|image|String | 專輯封面地址 |
- 1. 海知智能第三方技能插件開放平臺概述
- 2. 快速接入API
- 2.1 硬件接口調用
- 2.2 快速接入微信
- 2.3 API接入常見問題
- 3. 技能插件
- 3.1 基礎能力類
- 頂級過濾器
- 用戶知識圖譜
- 機器人檔案
- 通用閑聊
- 兒童閑聊
- Smart Reply
- 輕量閑聊
- 3.2 語音游戲類
- 成語接龍
- 詞匯樂園
- 詞語接龍
- 鸚鵡學舌
- 動腦猜猜
- 挑戰單詞
- 冒險世界
- 猜猜我是誰
- 阿拉丁學詩詞
- 貓貓托管所
- 漂流瓶
- 詩詞大會
- 國學大會
- 我愛猜歌名
- 我在看著你
- 燈謎猜猜
- 3.3 休閑娛樂類
- 星座運勢
- 悅耳聲音
- 幸運簽
- 調教機器人
- 娛樂推送
- 3.4 生活服務類
- 黃歷
- 計算器
- 古詩詞
- 時間詢問
- 翻譯類技能
- 天氣資訊
- 日程創建
- 日程創建指令
- 鬧鐘
- 食材知識
- 冥想音樂
- 格言
- 每日英語
- 漢語詞典
- 豆果菜譜
- 古文翻譯
- 3.5 音頻點播類
- 喜馬拉雅FM
- 新聞廣播
- 音樂點播
- Smart Music
- 兒童聽聽
- Smart Audio
- 兒童笑話
- 點播控制指令
- 3.6 視頻點播類
- 影視點播
- 3.7 百科知識類
- 人物百科
- 百科問答
- 實時百科
- 3.8 體育健康類
- 五分鐘健身
- 4. 開發者初級教程
- 4.1 開通服務
- 4.2 創建機器人
- 4.3 設置機器人
- 4.4 獲取技能插件
- 4.5 讓機器人學會聊天
- 4.6 導入知識庫
- 4.7 多種問答形式
- 4.8 數據統計
- 4.9 粉絲管理
- 5. 開發者中級教程
- 5.1 詞典運用
- 5.2 意圖處理
- 5.3 暗號使用
- 5.4 事件觸發
- 5.5 優先級
- 5.6 觸發器
- 5.7 快捷鍵
- 5.8 意圖報錯
- 6. 開發者高級教程
- 6.1 handlebars模版語言
- 6.2 JavaScript簡單介紹
- 6.3 JavaScript使用說明
- 6.4 JavaScript使用案例
- 6.5 JavaScript常見問題
- 7. 快速發布技能
- 8. 幫助中心
- 8.1 常見概念
- 8.2 幫助視頻
- 8.3 聯系我們