6.1 指令与控制

IOT 场景的关键是「指令」：用户说话 → 云端识别意图 → 下发 CALL_SKILL_EVENT → 设备端"照做"。 设备端收到指令事件无需再语义判断，直接调用对应功能模块（如红外开关/系统闹钟等）即可。 本章节重点说明：怎么建模指令、怎么配置、怎么测准确率。

下行指令事件 CALL_SKILL_EVENT 示例（点击展开）

{
    "code": 200,
    "msg": "Event success",
    "requestId": "1",
    "mid": "1",
    "contentType": "EVENT",
    "content": {
        "roundId": "0_1",
        "eventType": "CALL_SKILL_EVENT",
        "eventData": {
            "msg": "意图事件",
            "type": "CALL_SKILL_EVENT",
            "data": {
                "instructions": [
                    {
                        "action": "VOLUMN_SET",
                        "args": {"slotKey1": "slotValue"},
                        "desc": "音量调到XX"
                    }
                ],
                "intentClassify": "音量调到XX",
                "intentCode": "VOLUMN_SET"
            }
        }
    }
}

协议中 data 的 intentCode 属性值与 instructions 的 action 属性值等同，为首条指令的 intentCode 编码。多条动作指令同理，intentCode 取首条。

6.1.1 自定义指令协议

输出控制协议（单指令）

{
    "code": 200,
    "msg": "Event success",
    "requestId": "1",
    "mid": "1",
    "contentType": "EVENT",
    "content": {
        "roundId": "0_1",
        "eventType": "CALL_SKILL_EVENT",
        "eventData": {
            "msg": "意图事件",
            "type": "CALL_SKILL_EVENT",
            "data": {
                "instructions": [
                    {
                        "action": "VOLUMN_SET",
                        "args": {
                            "slotKey1": "slotValue",
                            "slotKey2": "slotValue"
                        },
                        "desc": "音量调到XX"
                    }
                ],
                "intentClassify": "音量调到XX",
                "intentCode": "VOLUMN_SET"
            }
        }
    }
}

协议中 data 的 intentCode 属性值与 instructions 的 action 属性值等同，为首条指令 intentCode 编码。

动作指令协议（多指令串行）

{
    "code": 200,
    "msg": "Event success",
    "requestId": "1",
    "mid": "1",
    "contentType": "EVENT",
    "content": {
        "roundId": "0_1",
        "eventType": "CALL_SKILL_EVENT",
        "eventData": {
            "msg": "意图事件",
            "type": "CALL_SKILL_EVENT",
            "data": {
                "instructions": [
                    {
                        "action": "ACTION_TURN_LEFT",
                        "desc": "向左转"
                    },
                    {
                        "action": "ACTION_TURN_RIGHT",
                        "desc": "向右转"
                    }
                ],
                "intentClassify": "向左转",
                "intentCode": "ACTION_TURN_LEFT"
            }
        }
    }
}

6.1.2 指令控制配置

具体参见JoyInside 运营平台使用说明：AIOT 指令

下一步

• 回看 WS 事件：读 4.4 WebSocket语音通道 —— CALL_SKILL_EVENT 指令事件格式
• 其他场景：读 6.2 媒体资源接入 / 6.3 魔法打印接入 / 6.4 视觉对话接入