消息类型速查
设备 ↔ 服务端 JSON / 二进制消息一览。
设备 → 服务端
| type | 说明 | 示例 |
|---|---|---|
hello | 握手（含设备上报数据） | 见上一章 |
listen | 控制录音状态 | {"type":"listen","state":"start"} |
abort | 打断当前 TTS 播放 | {"type":"abort","reason":"wake_word"} |
heartbeat | 心跳上报（30~60s） | 电量/网络/定位/音量等 |
iot | 设备状态查询应答 | {"type":"iot","request_id":"xx","data":{…}} |
Binary 帧 | Opus 音频流 | 60ms/帧，16kHz 单声道 |
listen 状态机
| state | 触发时机 | 服务端动作 |
|---|---|---|
start | 开始录音 / 唤醒后 | 启动一轮新对话与 ASR 识别 |
stop | 用户停止说话 | 结束本轮录音，触发识别 |
detect | 唤醒词命中 / 按键唤醒 | 可携带 text 直接作为输入发给智能体 |
服务端 → 设备
| type | 说明 | 示例 |
|---|---|---|
stt | ASR 识别结果 | {"type":"stt","text":"你好"} |
tts | TTS 播放状态控制 | {"type":"tts","state":"start|stop","text":"…"} |
action | 下发设备动作指令 | 见「指令字典」 |
device_query | 查询设备实时状态 | {"type":"device_query","request_id":"xx","query_type":"all"} |
Binary 帧 | TTS 音频数据 | Opus，24kHz |
平台支持快速回复：命中预设关键词时直接返回预合成语音，不走大模型，首次响应更快。在控制台「资源中心 → 快速回复」配置。