### 3.2.15 我在看著你 #### （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": "5e2ff621-ddb7-49f9-9083-1223a0aa23fb", "intents": [ { "parameters": { "answer": "選項一", "service": "WatchingYou" }, "action": "我在看，選擇", "name": "選項一", "result": { "chapterInfo": { "url": "https://qiniu.ruyi.ai/FjrDsjI_EwzHMQFfO1nOB06McdAK/2-1.mp3", "questionUrl": "https://qiniu.ruyi.ai/FgLdONGxK-a74I-OatG9ZmrusyOt/zhuan2-1.mp3", "preChapterId": "1", "opt1ChapterId": "3-1", "opt2ChapterId": "3-2", "id": "2-1" "type": "undefined" }, "outputs": [ { "type": "voice", "property": { "name": "選項一章節", "voice_url": "https://qiniu.ruyi.ai/FjrDsjI_EwzHMQFfO1nOB06McdAK/2-1.mp3" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "ec149eac-3d74-47c0-9603-0d080fca3550", "id": "57a53fc2-7ebf-41d2-bb95-48cd5d373666" } ], "meta_process_milliseconds": 144 } ``` **請求示例錯誤** 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": "ef69da52-ee34-42f5-8376-068a297bd175", "intents": [ { "parameters": { "sys.any": "不說", "service": "WatchingYou" }, "action": "我在看，當前進度", "name": "缺省回復", "result": { "chapterInfo": { "url": "https://qiniu.ruyi.ai/Fl8bbnVrkWkUMTrK3zkgXtGjuWBN/3-2.mp3", "questionUrl": "https://qiniu.ruyi.ai/FvQahiVsfqa1AB81d2KzqeJh1shX/zhuan3-2.mp3", "preChapterId": "2-1", "opt1ChapterId": "4-3", "opt2ChapterId": "4-4", "id": "3-2" "text": "可以再跟小愛說一次嗎？可以說選第幾項。不想玩了也可以說退出哦。", "type": "dialog" }, "outputs": [ { "type": "voice", "property": { "name": "缺省回復", "voice_url": "https://qiniu.ruyi.ai/Fl8bbnVrkWkUMTrK3zkgXtGjuWBN/3-2.mp3" } }, { "type": "dialog", "property": { "text": "可以再說一次嗎？可以說選第幾項。不想玩了也可以說退出哦。", "emotion": "suspect" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "ec149eac-3d74-47c0-9603-0d080fca3550", "id": "80dd4c8e-d98f-4ea3-8825-ba5c7df680d5" } ], "meta_process_milliseconds": 84 } ``` **請求示例退出** 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": "568c8908-1d6d-41a4-b6ee-52e9cfb03f1a", "intents": [ { "parameters": { "退出": "退出", "service": "WatchingYou" }, "name": "退出如意技能", "outputs": [ { "type": "voice", "property": { "name": "exit.mp3", "voice_url": "https://qiniu.ruyi.ai/FvLwKpcIw2NfrXM4Rom_7QLD1FnP/exit.mp3" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "ec149eac-3d74-47c0-9603-0d080fca3550", "id": "77cdcbc1-881f-46e9-84a6-3b3eb41f30d6", "action": "other" } ], "meta_process_milliseconds": 60 } ``` **詳細參數說明** |名稱|類型|說明| |:---|:---|:--- |service | String |服務名稱 |chapterInfo | Objec| 章節信息 |chapterInfo.ur| String |當前章節url |chapterInfo.idString|當前章節id |chapterInfo.questionUrl | String |轉述問章節url **指令清單** |指令名稱|范例| |:---|:--- |喚醒 | 打開我在看著你 |幫助 | 幫助 |重新開始 | 重新開始 |退出 | 退出