### 3.2.10 貓貓托管所
#### (1)功能說明
貓主人要出差30天,貓貓不知道該怎么辦了。你的貓貓托管所就是他們的不二選擇哦!作為育貓員,你需要在30天里細心照顧貓貓,給他喂食、陪他玩耍。通過與貓貓之間的互動,你與貓貓的親密值會不斷增加,達到一定程度就能獲得更高的等級哦~ 30天后,貓主人會領走貓貓,到時候看看你獲得的等級是什么吧!
#### (2)接口說明
**請求方法**
* POST
**請求地址**
* http://api.ruyi.ai/v2/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": "ce18e797-49f3-4af4-91de-077ff66e778b",
???"intents": [
???????{
???????????"parameters": {
???????????????"service": "cat"
???????????},
???????????"action": "貓貓情報",
???????????"name": "游戲怎么玩",
???????????"result": {
???????????????????"catCount": 1,
???????????????????"openGameTimes": 7,
???????????????????"name": "多爾袞",
???????????????????"intimacy": 525,
???????????????????"money": 0,
???????????????????"level": 3,
???????????????????"toNextLevelScore": 60,
???????????????????"startLevelUp": 0,
???????????????????"startDate": "Jan 15, 2019 4:47:32 PM",
???????????????????"lastInteractionDate": "Jan 17, 2019 11:49:06 AM",
???????????????????"interactionTimes": 5,
???????????????????"touchCatCount": 2,
???????????????????"autoDealDate": "Jan 17, 2019 11:47:44 AM",
???????????????????"degree": {
???????????????????????"satiety": 80,
???????????????????????"attention": 90,
???????????????????????"happiness": 70
???????????????????},
???????????????????"raisingDays": 2
??????????????????"text": "游戲周期為30天。玩家通過喂食、陪伴等“互動行為”來維持貓貓的各項“指標程度”,從而增加與貓貓的“親密值”。玩家的等級也就隨之增加,不斷地解鎖新的互動玩法。多爾袞飽腹程度是80%,還在等吃的呢,跟我說喂貓糧",
???????????????????"type": "dialog"
???????????},
???????????"outputs": [
???????????????{
???????????????????"type": "wechat.text",
???????????????????"property": {
???????????????????????"text": "游戲周期為30天。玩家通過喂食、陪伴等“互動行為”來維持貓貓的各項“指標程度”,從而增加與貓貓的“親密值”。玩家的等級也就隨之增加,不斷地解鎖新的互動玩法。多爾袞飽腹程度只有80%,跟我說喂貓糧"
???????????????????}
???????????????},
???????????????{
???????????????????"type": "dialog",
???????????????????"property": {
???????????????????"text": "游戲周期為30天。玩家通過喂食、陪伴等“互動行為”來維持貓貓的各項“指標程度”,從而增加與貓貓的“親密值”。玩家的等級也就隨之增加,不斷地解鎖新的互動玩法。多爾袞飽腹程度是80%,還在等吃的呢,跟我說喂貓糧",
???????????????????????"emotion": "calm"
???????????????????}
???????????????}
???????????],
???????????"score": "1.0",
???????????"scoreColor": "c4",
???????????"is_match": 1,
???????????"skill_id": "0ce04a78-edb0-4398-bd84-64cc7af66d21",
???????????"id": "e933dcdd-a56f-4139-81eb-a69a5dc65719"
???????}
???],
???"meta_process_milliseconds": 198
}
```
**請求示例正確**
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": "dd57bf4f-8308-41b7-b263-9877b1162861",
???"intents": [
???????{
???????????"parameters": {
???????????????"action": "satiety#20#3#feedfood",
???????????????"service": "cat"
???????????},
???????????"action": "貓貓互動",
???????????"name": "互動",
???????????"result": {
???????????????????"catCount": 1,
???????????????????"openGameTimes": 7,
???????????????????"name": "多爾袞",
???????????????????"intimacy": 525,
???????????????????"money": 0,
???????????????????"level": 3,
???????????????????"toNextLevelScore": 60,
???????????????????"startLevelUp": 0,
???????????????????"startDate": "Jan 15, 2019 4:47:32 PM",
???????????????????"lastInteractionDate": "Jan 17, 2019 11:48:45 AM",
???????????????????"interactionTimes": 5,
???????????????????"touchCatCount": 2,
???????????????????"autoDealDate": "Jan 17, 2019 11:47:44 AM",
???????????????????"degree": {
???????????????????????"satiety": 80,
???????????????????????"attention": 90,
???????????????????????"happiness": 70
???????????????????},
???????????????????"raisingDays": 2
???????????????????"text": "http://image.ruyi.ai/chanshiguan/喂貓糧old.m4a",
????????????????????"type": "dialog"
???????????},
???????????"outputs": [
???????????????{
???????????????????"type": "wechat.text",
???????????????????"property": {
???????????????????????"text": "http://image.ruyi.ai/chanshiguan/喂貓糧old.m4a"
???????????????????}
???????????????},
???????????????{
???????????????????"type": "voice",
???????????????????"property": {
???????????????????????"name": null,
???????????????????????"voice\_url": "http://image.ruyi.ai/chanshiguan/喂貓糧old.m4a"
???????????????????}
???????????????},
???????????????{
???????????????????"type": "dialog",
???????????????????"property": {
???????????????????????"text": "多爾袞在大口吃貓糧!他的飽腹程度是80%,還在等吃的呢,跟我說喂牛奶",
???????????????????????"emotion": "calm"
???????????????????}
???????????????}
???????????],
???????????"score": "1.0",
???????????"scoreColor": "c4",
???????????"is_match": 1,
???????????"skill_id": "0ce04a78-edb0-4398-bd84-64cc7af66d21",
???????????"id": "a1e09b67-93bf-4a77-bde8-49d732d8cf17"
???????}
???],
???"meta_process_milliseconds": 282
}
```
**請求示例退出**
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": "15f146df-bc6e-48fe-b967-c78acdac2fe6",
"intents": [
{
"parameters": {
"any": "",
"退出": "結束",
"any1": "",
"service": "cat"
},
"action": "貓貓情報",
"name": "退出如意技能",
"result": {
"catCount": 1,
"openGameTimes": 7,
"name": "多爾袞",
"intimacy": 525,
"money": 0,
"level": 3,
"toNextLevelScore": 60,
"startLevelUp": 0,
"startDate": "Jan 15, 2019 4:47:32 PM",
"lastInteractionDate": "Jan 17, 2019 11:49:16 AM",
"interactionTimes": 5,
"touchCatCount": 2,
"autoDealDate": "Jan 17, 2019 11:47:44 AM",
"degree": {
"satiety": 80,
"attention": 90,
"happiness": 70
},
"raisingDays": 2
"text": "已退出貓貓托管所。多爾袞的飽腹程度為80%、被關注程度為90%,開心度程度為70%,注意哦!指標未滿。待會有空求回來照顧多爾袞。",
"type": "dialog"
},
"outputs": [
{
"type": "wechat.text",
"property": {
"text": "已退出貓貓托管所。想照顧貓貓的時候記得來找我,貓貓在這等著你哦"
}
},
{
"type": "voice",
"property": {
"name": "room_door_C.mp3",
"voice_url": "https://qiniu.ruyi.ai/FvL1ssum7VALYxGsd02Yk6WYKRhx/room_door_C.mp3"
}
},
{
"type": "dialog",
"property": {
"text": "已退出貓貓托管所。多爾袞的飽腹程度為80%、被關注程度為90%,開心度程度為70%,注意哦!指標未滿。待會有空求回來照顧多爾袞。",
"emotion": "calm"
}
}
],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"skill_id": "0ce04a78-edb0-4398-bd84-64cc7af66d21",
"id": "5d0819ca-7a70-46ab-800b-6c78644b295a"
}
],
"meta_process_milliseconds": 124
}
```
**詳細參數說明**
|名稱|類型|說明|
|:---|:---|:---
|service | String |服務名稱
|action|String|互動的詞典參數,格式 degree#changeValue#needLevel#behavour
|catCount | int | 貓貓數量
|openGameTimes | int |打開游戲次數
|name|String|貓貓名字
|intimacy | int |親密度
|money|int|金錢數(本期暫未支持)
|level | int |貓貓等級
|startLevelUp|int|1:代表貓貓等級有提升。默認0
|startDate| String |開始時間
|lastInteractionDate|String|最近一次交互時間
|interactionTimes | int |交互次數
|touchCatCount|int|摸貓次數
|degree | String |相關指標參數
|degree.satiety | int |飽腹度
|degree.attention|int|被關注度
|degree.happiness | int |開心程度
|raisingDays | int |養貓天數
**指令清單**
|指令名稱|范例|
|:---|:---
|喚醒 | 打開貓貓托管所
|游戲玩法介紹 | 游戲怎么玩
|互動動作 | 喂貓糧
|退出 | 退出
- 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 聯系我們