场景使用指南

概述

在物联网和 ESP RainMaker 中，场景是一组预定义的参数值集合，可通过手机应用、语音助手或日程计划进行触发。借助场景功能，用户可以通过一条命令同时触发多个操作，轻松实现自动化控制，更加便捷高效。场景功能完全在节点端作为服务实现，简化了控制流程。过程中，云端仅作为通信中介。

例如，“傍晚”场景可以用于调节灯光，“夜间”场景可以调暗灯光并启动制冷。场景功能优化了能源使用，提供了一种实用且具有成本效益的物联网解决方案。

• 要了解更多关于场景的信息，请参阅此文档。
• 关于跨节点场景在手机应用中的注意事项，请参阅此文档。
• 关于语音助手集成的注意事项，请参阅此文档。

---

使用指南

启用场景

ESP RainMaker 提供了一个 API 来启用场景：

esp_err_t esp_rmaker_scenes_enable(void);

注意

此 API 应在 esp_rmaker_node_init() 之后、esp_rmaker_start() 之前调用。

• 支持的最大场景数量可以通过 CONFIG_ESP_RMAKER_SCENES_MAX_SCENES 选项进行配置。
• 您可在 idf.py menuconfig 中找到此选项，具体步骤如下：

---

• 开启场景停用需设置：CONFIG_ESP_RMAKER_SCENES_DEACTIVATE_SUPPORT=y。
• 默认不支持停用场景，因为停用场景通常意味着需要恢复参数的原始值，而这一过程较为复杂，可能导致行为不一致。
• 即使支持场景的停用功能，RainMaker 核本身也不会执行停用逻辑，而是：
  • 在收到停用请求时，调用对应服务的写入回调函数。
  • 由应用程序中注册的回调函数来保存或恢复参数值。