From fcef2224820632b331c5e4b82600645ba63492d6 Mon Sep 17 00:00:00 2001
From: luozheng <1732036298@qq.com>
Date: Mon, 3 Nov 2025 14:26:10 +0800
Subject: [PATCH] =?utf8?q?ln=E5=8D=8F=E8=AE=AE=E6=96=87=E6=A1=A3=E6=9B=B4?=
 =?utf8?q?=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 ...45\345\217\243\346\226\207\346\241\243.md" | 141 +++++++++++++++++-
 1 file changed, 140 insertions(+), 1 deletion(-)

diff --git "a/code/sdk/zhihui/leiniao/\350\256\276\345\244\207API\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/code/sdk/zhihui/leiniao/\350\256\276\345\244\207API\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 8b6da843f..a0cbe8245 100644
--- "a/code/sdk/zhihui/leiniao/\350\256\276\345\244\207API\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/code/sdk/zhihui/leiniao/\350\256\276\345\244\207API\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -1380,6 +1380,13 @@ sequenceDiagram
         and 日程提醒
             Server->>Device: WebSocket推送<br/>{"command": "ScheduleReminder", "data": {"scheduleName": "...", "reminderContent": "..."}}
             Device->>Device: 播放提醒内容
+        and 哄睡模式询问
+            Device->>Device: 识别到哄睡意图
+            Device->>Server: WebSocket发送<br/>{"command": "SleepModeInquire", "data": {"intention": "START_SLEEP_MODE", "chatId": "..."}}
+            Server->>Server: 生成询问内容
+            Server->>Device: WebSocket推送<br/>{"command": "SleepModeInquireAck", "data": {"textContent": "...", "audioUrl": "...", ...}}
+            Server->>Device: WebSocket二进制消息<br/>流式发送音频数据
+            Device->>Device: 播放询问音频等待用户确认
         end
         
     else Token验证失败
@@ -1816,6 +1823,88 @@ WebSocket连接需要设备Token认证，有以下两种方式传递Token：
 }
 ```
 
+#### 哄睡模式询问请求 (SleepModeInquire)
+**命令描述**：客户端发送哄睡模式询问请求，用于在识别到哄睡意图后获取二次确认的询问内容
+**协议说明**：
+- 当语音对话识别到哄睡意图（StartSleepMode）后，设备发送此命令获取询问内容
+- 服务端会返回SleepModeInquireAck响应，包含询问的文本和音频
+- 设备播放询问内容后，等待用户确认是否真的要进入哄睡模式
+- 也支持退出哄睡时的询问场景（EXIT_SLEEP_MODE）
+
+**消息格式**：
+```json
+{
+  "deviceId": "设备ID",
+  "timestamp": 1640995200,
+  "messageId": "消息ID",
+  "command": "SleepModeInquire",
+  "data": {
+    "intention": "用户意图",
+    "chatId": "对话ID，用于标识本次询问"
+  }
+}
+```
+
+**消息示例**：
+```json
+{
+  "deviceId": "DEVICE_001",
+  "timestamp": 1640995200,
+  "messageId": "sleep_inquire_001",
+  "command": "SleepModeInquire",
+  "data": {
+    "intention": "START_SLEEP_MODE",
+    "chatId": "chat_12345"
+  }
+}
+```
+
+**data字段说明**：
+
+| 字段名 | 类型 | 描述 |
+|--------|------|------|
+| intention | String | 用户意图，取值：START_SLEEP_MODE（开启哄睡）或 EXIT_SLEEP_MODE（退出哄睡） |
+| chatId | String | 对话ID，用于标识本次询问，建议使用UUID |
+
+**使用场景**：
+1. **开启哄睡前确认**：语音对话识别到StartSleepMode意图后，发送此命令获取确认询问
+2. **退出哄睡确认**：用户想要退出哄睡模式时，发送此命令获取退出确认询问
+
+**服务端响应**：
+服务端收到哄睡询问请求后，会通过WebSocket推送SleepModeInquireAck消息：
+
+```json
+{
+  "deviceId": "DEVICE_001",
+  "timestamp": 1640995201,
+  "messageId": "sleep_inquire_ack_001",
+  "command": "SleepModeInquireAck",
+  "data": {
+    "intention": "START_SLEEP_MODE",
+    "textContent": "你想听故事吗？如果想听，请告诉我你想听什么类型的故事",
+    "audioUrl": "https://example.com/audio/sleep_inquire.mp3",
+    "audioDuration": 3000,
+    "chatId": "chat_12345"
+  }
+}
+```
+
+**服务端响应data字段说明**：
+
+| 字段名 | 类型 | 描述 |
+|--------|------|------|
+| intention | String | 用户意图，与请求中的意图对应 |
+| textContent | String | 询问的文本内容 |
+| audioUrl | String | 询问音频文件URL |
+| audioDuration | Integer | 音频时长，单位：毫秒 |
+| chatId | String | 对话ID，与请求中的chatId对应 |
+
+**音频流传输说明**：
+- 除了返回audioUrl外，服务端还会通过WebSocket二进制消息流式发送音频数据
+- 音频数据分块发送，每块不超过20KB
+- 发送间隔由服务端配置控制
+- 设备可以边接收边播放，实现流畅的播放体验
+
 ### 客户端应答消息 (ACK Messages)
 
 客户端在收到服务端推送的某些命令后，需要发送应答消息（ACK）来确认命令的接收和执行状态。所有 ACK 消息遵循统一的消息格式。
@@ -2436,7 +2525,57 @@ WebSocket连接需要设备Token认证，有以下两种方式传递Token：
 
 **data字段说明**：与语音选择故事响应相同
 
-#### 5. 角色切换 (CharacterChange)
+#### 5. 哄睡模式询问响应 (SleepModeInquireAck)
+**命令描述**：服务端推送哄睡模式询问响应，返回询问的文本和音频内容
+**协议说明**：
+- 服务端收到客户端的SleepModeInquire请求后，返回此响应
+- 响应包含询问的文本内容和音频URL
+- 除了audioUrl外，服务端还会通过WebSocket二进制消息流式发送音频数据
+- 音频数据分块发送，每块不超过20KB，间隔发送
+
+**消息示例**：
+```json
+{
+  "deviceId": "DEVICE_001",
+  "timestamp": 1640995201,
+  "messageId": "sleep_inquire_ack_001",
+  "command": "SleepModeInquireAck",
+  "data": {
+    "intention": "START_SLEEP_MODE",
+    "textContent": "你想听故事吗？如果想听，请告诉我你想听什么类型的故事",
+    "audioUrl": "https://example.com/audio/sleep_inquire.mp3",
+    "audioDuration": 3000,
+    "chatId": "chat_12345"
+  }
+}
+```
+
+**data字段说明**：
+
+| 字段名 | 类型 | 描述 |
+|--------|------|------|
+| intention | String | 用户意图，与请求中的意图对应，取值：START_SLEEP_MODE 或 EXIT_SLEEP_MODE |
+| textContent | String | 询问的文本内容 |
+| audioUrl | String | 询问音频文件URL |
+| audioDuration | Integer | 音频时长，单位：毫秒 |
+| chatId | String | 对话ID，与请求中的chatId对应 |
+
+**音频流传输说明**：
+- 在返回此消息后，服务端会立即通过WebSocket二进制消息发送音频流数据
+- 音频数据按chatId进行标识，设备端需要根据chatId匹配音频数据
+- 音频数据分块传输，每块不超过20KB
+- 块与块之间有时间间隔，由服务端配置控制
+- 设备端可以边接收边播放，实现流畅的播放体验
+- 传输完成后不会有结束标记，设备应根据音频长度或播放完成来判断
+
+**使用流程**：
+1. 设备发送SleepModeInquire请求
+2. 服务端返回SleepModeInquireAck响应（包含文本和audioUrl）
+3. 服务端开始发送音频二进制数据流
+4. 设备接收并播放音频
+5. 用户听到询问后，通过语音回复确认
+
+#### 6. 角色切换 (CharacterChange)
 **命令描述**：通知设备切换到指定角色
 **消息示例**：
 ```json
-- 
2.17.1