### 3.2.5 動腦猜猜
#### （1）功能說明
       動腦猜猜是猜謎游戲，用戶說“動腦猜猜"、“猜謎”、“猜謎語”等關鍵詞語時可進入游戲，有數字，稱呼，乘法，水果，動物，燈謎 6 種關卡，其中最簡單的是數字，最難的是燈謎，難度逐項遞增，更增添了趣味感。機器人出題，用戶回答，有兩次回答機會，兩次都未回答對機器人就會給出正確答案，可選擇跳過。
#### （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": "b2c76ed1-0747-478a-a53a-364d4ed853a2",
"intents": [{
"parameters": {
"tag": "水果",
"text": "櫻桃",
"score": "0",
"numChanceLeft": "1",
"prevQuestion": "小小車厘子，紅紅小果子（打一水果）（2個字）",
"prevAnswer": "櫻桃",
"prevResult": "",
"answer": "櫻桃",
"lastAnswer": "櫻桃",
"lastQuestion": "小小車厘子，紅紅小果子（打一水果）（2個字）",
"game-status": "playing",
"service": "dongnaocaicai"
},
"action": "sys.action.game/dongnaocaicai/play",
"name": "猜猜-玩游戲",
"result": {
"lastQuestion": "圓圓的水果高高掛，喝完水來把肉吃（打一水果）（2個字）",
"lastAnswer": "椰子",
"lastExplanation": "",
"explanationUserSay": "",
"score": 1,
"totalNumUserSay": 1,
"numChanceLeft": 2,
"prevQuestion": "小小車厘子，紅紅小果子（打一水果）（2個字）##圓圓的水果高高掛，喝完水來把肉吃（打一水果）（2個字）",
"prevAnswer": "櫻桃##椰子",
"prevResult": "1",
"isRightAnswer": true,
"totalNumQuestion": 2,
"text": "你說對了！正確答案是：櫻桃。第2題，圓圓的水果高高掛，喝完水來把肉吃（打一水果）（2個字）",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "你說對了！正確答案是：櫻桃。第2題，圓圓的水果高高掛，喝完水來把肉吃（打一水果）（2個字）"
}
}, {
"type": "dialog",
"property": {
"text": "你說對了！正確答案是：櫻桃。第2題，圓圓的水果高高掛，喝完水來把肉吃（打一水果）（2個字）",
"emotion": "calm"
}
}],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"id": "8a5fa1c8-324b-4564-b198-cf59f87d5911"
}],
"meta_process_milliseconds": 151
}
}
```
**請求示例**
（跳過）
* 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": "ba0d7d60-ebc0-46f9-9952-1b4bbcd5729b",
"intents": [{
"parameters": {
"tag": "水果",
"text": "text",
"score": "0",
"numChanceLeft": "1",
"prevQuestion": "渾身黃袍皮粗糙，頭頂冠芽不算高（打一水果）（2個字）",
"prevAnswer": "菠蘿",
"prevResult": "",
"answer": "菠蘿",
"lastAnswer": "菠蘿",
"lastQuestion": "渾身黃袍皮粗糙，頭頂冠芽不算高（打一水果）（2個字）",
"game-status": "playing",
"service": "dongnaocaicai"
},
"action": "sys.action.game/dongnaocaicai/play",
"name": "猜猜-玩游戲-跳過",
"result": {
"lastQuestion": "高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"lastAnswer": "甘蔗",
"lastExplanation": "",
"explanationUserSay": "",
"score": 0,
"totalNumUserSay": 1,
"numChanceLeft": 2,
"prevQuestion": "渾身黃袍皮粗糙，頭頂冠芽不算高（打一水果）（2個字）##高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"prevAnswer": "菠蘿##甘蔗",
"prevResult": "0",
"isRightAnswer": false,
"totalNumQuestion": 2,
"text": "正確答案是：菠蘿。第2題，高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "正確答案是：菠蘿。第2題，高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）"
}
},
{
"type": "dialog",
"property": {
"text": "正確答案是：菠蘿。第2題，高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"emotion": "happy"
}
}],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"id": "0d74bc6e-7881-46bb-acb3-3568d82c7ba9"
}],
"meta_process_milliseconds": 71
}
}
```
**請求示例**
（重復）
* 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": "59b9dcb1-603a-4b85-a902-ac6b02d3ca26",
"intents": [{
"parameters": {
"tag": "水果",
"text": "text",
"score": "0",
"numChanceLeft": "3",
"prevQuestion": "渾身黃袍皮粗糙，頭頂冠芽不算高（打一水果）（2個字）##高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"prevAnswer": "菠蘿##甘蔗",
"prevResult": "0",
"answer": "甘蔗",
"lastAnswer": "甘蔗",
"lastQuestion": "高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"game-status": "playing",
"service": "dongnaocaicai"
},
"action": "sys.action.game/dongnaocaicai/play",
"name": "猜猜-玩游戲-重復題目",
"result": {
"lastQuestion": "高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"lastAnswer": "甘蔗",
"lastExplanation": "",
"explanationUserSay": "",
"score": 0,
"totalNumUserSay": 1,
"numChanceLeft": 2,
"prevQuestion": "渾身黃袍皮粗糙，頭頂冠芽不算高（打一水果）（2個字）##高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"prevAnswer": "菠蘿##甘蔗",
"prevResult": "0",
"isRightAnswer": false,
"totalNumQuestion": 2,
"text": "第2題， 高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "第2題， 高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）"
}
},
{
"type": "dialog",
"property": {
"text": "第2題， 高高瘦瘦似竹子，糖水豐富甜如絲（打一水果）（2個字）",
"emotion": "happy"
}
}],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"id": "060944b8-36c5-41ec-a126-4f5fce89f784"
}],
"meta_process_milliseconds": 48
}
}
```
**請求示例**
（退出）
* 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": "b2dda37a-6ebd-484e-aaab-0586ce27bf88",
"intents": [{
"parameters": {
"tag": "水果",
"score": "0",
"game-status": "over",
"totalNumQuestion": "2",
"service": "dongnaocaicai"
},
"action": "0",
"name": "答題中-退出",
"result": {
"text": "你在稱呼猜猜中說答對了0道題，再接再厲哦！歡迎下次再玩動腦猜猜。",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "你在稱呼猜猜中說答對了0道題，再接再厲哦！歡迎下次再玩動腦猜猜。"
}
},
{
"type": "dialog",
"property": {
"text": "你在稱呼猜猜中說答對了0道題，再接再厲哦！歡迎下次再玩動腦猜猜。",
"emotion": "calm"
}
}],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"id": "0099f058-7e63-4080-9c1d-56596a0acb61"
}],
"meta_process_milliseconds": 88
}
}
```
**詳細參數說明**
|名稱|類型|說明|
|:---|:---|:---
|service | String |服務名稱
|tag|String|選擇類別
|isRightAnswer|Boolean |判斷是否為正確答案，是則為 true
|numChanceLeft|String|剩余回答機會
|score|Integer|當前得分
|prevQuestion|String|上一個問題和之前的問題
|prevAnswer|String|上一個答案和之前的答案
|lastAnswer|String|上一個答案
|lastQuestion|String| 上一個問題
|game-status|String|游戲當前所處的狀態
|answer|String|當前這一輪的答案
|totalNumQuestion|String|所回答的問題總數
**指令清單**
| 指令名稱 | 范例 |
| :--- | :--- |
| 喚醒| 動腦猜猜|
| 選擇類型| 數字|
| 玩游戲| 1|
| 重復| 重復|
| 跳過| 跳過|
| 退出| 退出|
- 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 聯系我們