指令字典
action 下发的系统指令与能力类指令。
智能体执行技能后,通过 action 消息向设备下发动作指令。设备根据 name 执行对应行为,params 为 JSON 对象参数。
{
"type": "action",
"action": { "name": "set_volume", "params": { "volume": 80 } }
}系统指令
必选 指令所有设备都应实现;可选 指令按硬件能力支持。设备可在 hello 的 features 中声明自身能力。
| 指令 name | 参数 | 设备行为 | 级别 |
|---|---|---|---|
standby | {} | 进入待机 | 必选 |
wake | {} | 从待机唤醒 | 必选 |
set_volume | { volume: 0-100 } | 设置音量 | 必选 |
reboot | {} | 重启设备 | 可选 |
set_brightness | { brightness: 0-100 } | 设置屏幕亮度 | 可选 |
play_emotion | { emotion: "happy"… } | 播放表情 | 可选 |
motion | { action: "nod"… } | 执行机械动作 | 可选 |
能力类指令(后端工具触发)
| 指令 / 工具 | 说明 | 返回形态 |
|---|---|---|
get_datetime | 查询当前日期时间 | 文本回复(TTS) |
set_alarm | 设置闹钟,到点由平台下发提醒 | action 提醒指令 |
get_weather | 天气查询 | 文本回复(TTS) |
iot_control | 智能家居控制 | 见下一章 |
设备执行 device_query 后,应通过 iot 消息回传带相同 request_id 的状态数据。