设备接口文档更新 2386/1 2386/head 2387/target/1
authorluozheng <1732036298@qq.com>
Wed, 24 Sep 2025 09:28:28 +0000 (17:28 +0800)
committerluozheng <1732036298@qq.com>
Wed, 24 Sep 2025 09:28:28 +0000 (17:28 +0800)
code/sdk/zhihui/leiniao/设备API接口文档.md

index 9e7768f..c73d5e1 100644 (file)
@@ -964,11 +964,11 @@ sequenceDiagram
 | 字段名 | 类型 | 描述 | 可选值 |\r
 |--------|------|------|--------|\r
 | eyesShape | String | 眼型 | calm-eyes, round-eyes, upturned-eyes |\r
-| hairColor | String | 发色 | light-brown, dark-brown, black, white, gray, blue, purple, gold |\r
-| eyesColor | String | 瞳色 | red, yellow, blue, green, purple, brown, purple-orange-gradient, blue-pink-gradient, yellow-green-gradient |\r
-| hairStyle | String | 发型 | side-parted-comma, m-shaped-bangs, diagonal-bangs, center-parted-bangs, straight-bangs, side-parted-texture |\r
-| screenImage | String | 屏保图片URL | |\r
-| screenImageAsEmoji | Boolean | 屏保图片是否作为对话表情 | 默认false |\r
+| hairColor | String | 发色 | light-brown, dark-brown, warm-orange, black, white, gray, blue, purple, gold |\r
+| eyesColor | String | 瞳色 | red, yellow, blue, green, purple, brown, amber, purple-orange-gradient, blue-pink-gradient, yellow-green-gradient |\r
+| hairStyle | String | 发型 | side-parted-comma, m-shaped-bangs, diagonal-bangs, center-parted-bangs, straight-bangs, side-parted-texture, curly-hair |\r
+| deviceScreen | String | 设备屏保URL | |\r
+| screenImageAsEmoji | Boolean | 屏保是否作为表情 | 默认false |\r
 \r
 \r
 #### 错误码\r
@@ -1588,12 +1588,24 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
     "finished": false,\r
     "data": {\r
       "textContent": "你好,我听到了你的话",\r
-      "audioUrl": "https://example.com/response_audio.mp3"\r
+      "audioUrl": "https://example.com/response_audio.mp3",\r
+      "intention": null,\r
+      "npcEmotion": null\r
     }\r
   }\r
 }\r
 ```\r
 \r
+**服务响应data.data字段说明**:\r
+\r
+| 字段名 | 类型 | 描述 |\r
+|--------|------|------|\r
+| textContent | String | 回复的文本内容 |\r
+| audioUrl | String | 回复音频文件URL |\r
+| intention | String | 用户意图识别结果,如"StartSleepMode"等 |\r
+| npcEmotion | String | NPC情感状态,如"happy"等 |\r
+\r
+\r
 #### 语音选择故事请求 (ChooseStoryRequest)\r
 **命令描述**:客户端发送语音选择故事请求,用户通过语音表达故事偏好,系统根据语音内容选择相应故事\r
 **协议说明**:\r
@@ -1799,7 +1811,8 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
     "data": {\r
       "textContent": "你好,我听到了你的话",\r
       "audioUrl": "https://example.com/response_audio.mp3",\r
-      "intention": null\r
+      "intention": null,\r
+      "npcEmotion": null\r
     },\r
     "errorCode": null\r
   }\r
@@ -1822,6 +1835,7 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
 | textContent | String | 回复的文本内容 |\r
 | audioUrl | String | 回复音频文件URL |\r
 | intention | String | 用户意图识别结果,如"StartSleepMode"等 |\r
+| npcEmotion | String | NPC情感状态,如"happy"等 |\r
 \r
 #### 3. 语音选择故事响应 (ChooseStoryResponse)\r
 **命令描述**:服务端推送语音选择故事响应,流式返回故事内容\r
@@ -1906,7 +1920,7 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
       "hairColor": "blue",\r
       "eyesColor": "green",\r
       "hairStyle": "side-parted",\r
-      "screenImage": "https://example.com/avatar.jpg",\r
+      "deviceScreen": "https://example.com/device_screen.bin",\r
       "screenImageAsEmoji": false\r
     }\r
   }\r
@@ -1926,11 +1940,11 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
 | 字段名 | 类型 | 描述 | 可选值 |\r
 |--------|------|------|--------|\r
 | eyesShape | String | 眼型 | calm-eyes, round-eyes, upturned-eyes |\r
-| eyesColor | String | 瞳色 | red, yellow, blue, green, purple, brown, purple-orange-gradient, blue-pink-gradient, yellow-green-gradient |\r
-| hairColor | String | 发色 | light-brown, dark-brown, black, white, gray, blue, purple, gold |\r
-| hairStyle | String | 发型 | side-parted-comma, m-shaped-bangs, diagonal-bangs, center-parted-bangs, straight-bangs, side-parted-texture |\r
-| screenImage | String | 屏保图片URL | |\r
-| screenImageAsEmoji | Boolean | 屏保图片是否作为对话表情 | 默认false |\r
+| eyesColor | String | 瞳色 | red, yellow, blue, green, purple, brown, amber, purple-orange-gradient, blue-pink-gradient, yellow-green-gradient |\r
+| hairColor | String | 发色 | light-brown, dark-brown, warm-orange, black, white, gray, blue, purple, gold |\r
+| hairStyle | String | 发型 | side-parted-comma, m-shaped-bangs, diagonal-bangs, center-parted-bangs, straight-bangs, side-parted-texture, curly-hair |\r
+| deviceScreen | String | 设备屏保URL | |\r
+| screenImageAsEmoji | Boolean | 屏保作为表情 | 默认false |\r
 \r
 **枚举说明**:\r
 \r
@@ -1953,6 +1967,7 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
 | green | 绿 |\r
 | purple | 紫 |\r
 | brown | 棕 |\r
+| amber | 琥珀 |\r
 | purple-orange-gradient | 紫橙渐变 |\r
 | blue-pink-gradient | 蓝粉渐变 |\r
 | yellow-green-gradient | 黄绿渐变 |\r
@@ -1963,6 +1978,7 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
 |--------|------|\r
 | light-brown | 浅棕色 |\r
 | dark-brown | 深棕色 |\r
+| warm-orange | 暖橙色 |\r
 | black | 黑色 |\r
 | white | 白色 |\r
 | gray | 灰色 |\r
@@ -2001,7 +2017,7 @@ WebSocket连接需要设备Token认证,有以下两种方式传递Token:
       "hairColor": "blue",\r
       "eyesColor": "green",\r
       "hairStyle": "side-parted-comma",\r
-      "screenImage": "https://example.com/new_avatar.jpg",\r
+      "deviceScreen": "https://example.com/new_avatar.bin",\r
       "screenImageAsEmoji": true\r
     }\r
   }\r