我在看着你 · ruyi.ai开发者文档

### 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 **指令清单** |指令名称|范例| |:---|:--- |唤醒 | 打开我在看着你 |帮助 | 帮助 |重新开始 | 重新开始 |退出 | 退出