### 3.2.7 冒险世界 #### （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": "eab1b9bb-8ea0-4abc-80b6-8a436f5c228b", "intents": [ { "parameters": { "service": "Word reasoning games" }, "name": "唤醒-介绍规则", "result": { "text": "没听清就和我说：重听规则。 准备好了跟我说：开始。", "type": "dialog" }, "outputs": [ { "type": "wechat.text", "property": { "text": "本文字游戏的冒险过程中会出现一些提示，要通过正确的思考和准确的判断，从几个选项中选择故事的发展方向，直接说选项就可以哦。这会带来不同的结果。" } }, { "type": "wechat.text", "property": { "text": "主要角色为4人，其中以第一人称“我”为你自己。其他三人是： 1.琳，我的女友，是一位优秀的护士。2.罗非，我的好友，自由搏击教练。 3.艾洛，我的好友，恐怖小说作家。" } }, { "type": "wechat.text", "property": { "text": "没听清就和我说：重听规则。 准备好了跟我说：开始。" } }, { "type": "voice", "property": { "name": "规则介绍_.mp3", "voice_url": "https://qiniu.ruyi.ai/FsEH6fYv5fx04aJqdLyWmzvYRai5/规则介绍_.mp3" } }, { "type": "dialog", "property": { "text": "请先收听游戏规则，如果没听清就说：重听规则。 和我说：开始游戏，就能进入故事情节哦。", "emotion": "calm" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "8b6cf021-8a47-4895-8973-ef4e5eb347e4", "action": "dialog" } ], "meta_process_milliseconds": 48 } } ``` **详细参数说明** |名称|类型|说明| |:---|:---|:--- |service | String |服务名称 |voice_url|String|音频链接