跳到主要内容

场景使用指南（手机应用）

about

在通用 IoT 语境，特别是 ESP RainMaker 中，“场景”指的是一组被设置为特定数值的参数，其中一个或多个设备可能分布在多个节点上。

请注意，场景是静态实体，需要通过某种方式进行激活，比如通过手机应用、语音助手或预定义的计划任务等。

与 ESP RainMaker 的其他功能一样，场景功能完全在节点端以“服务”的形式实现，云端后端仅作为节点与客户端（如手机应用）之间的通信网关。

  • 若想了解此功能的更多信息，请点击此处。
  • 关于固件中场景功能的使用方法，请点击此处。
  • 关于与语音助手集成的场景注意事项，请点击此处。

使用指南​

跨节点场景​

  • 如上所述，场景信息由节点维护，而不是云端后端。但在实际使用中，常常需要多个节点共同构成一个场景。
  • 对于这类场景，客户端会在多个节点中使用相同的场景 ID。
  • 在查询时，客户端会查找所有节点中共有的场景 ID，并统一进行展示。

以下有效载荷展示了如何跨多个节点创建场景。

使用以下有效载荷向 {{base_url}}/v1/user/nodes/params 发起 POST 请求：

JSON 载荷（展开/收起）
[{
    "node_id": "<nodeid_1>",
    "payload": {
        "Scenes": {
            "Scenes": [{
                "name": "Night1",
                "operation": "add",
                "id": "1112",
                "action": {
                    "Light": {
                        "Power": true,
                        "Hue": 280
                    }
                }
            }]
        }
    }
}, {
    "node_id": "<nodeid_2>",
    "payload": {
        "Scenes": {
            "Scenes": [{
                "name": "Night1",
                "operation": "add",
                "id": "1112",
                "action": {
                    "Switch": {
                        "Power": true
                    }
                }
            }]
        }
    }
}]

On this page