跳转到主要内容
开始创作
开发文档

指令字典

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 的状态数据。