### 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|音頻鏈接