IoTManager/src/modules/SysExt.cpp

#include "Global.h"
#include "classes/IoTItem.h"

// Пример модуля расширения возможностей системы на примере добавления новых команд в сценарии
// При комбинации использования doByInterval() и execute() можно обеспечить интеграцию с внешними сервисами, такими как Telegram, например.
// 

class SysExt : public IoTItem {
   public:
    SysExt(String parameters): IoTItem(parameters) {
        // инициализация внутренних переменных и объектов для взаимодействия с внешними системами
        //jsonRead(parameters, "addr", addr);   // получаем параметры из настроек модуля. Наименования могут быть любыми.
    }  
    
    void doByInterval() {
        // выполнение периодических проверок каждые Int секунд из настроек модуля

        //regEvent(Значение, Описание);   // регистрация найденного события после проверок для запуска сценариев и других реакций в системе
    }

    //void loop() {
        // выполнение необходимых проверок в теле основного цикла программы.
        // ВАЖНО: 1. при использовании loop() отключается doByInterval()
        //        2. любые заминки в данном цикле повлияют на общую работу системы
    //}

    IoTValue execute(String command, std::vector<IoTValue> &param) {
        // реакция на вызов команды модуля из сценария
        // String command - имя команды после ID. (ID.Команда())
        // param - вектор ("массив") значений параметров переданных вместе с командой: ID.Команда("пар1", 22, 33) -> param[0].ValS = "пар1", param[1].ValD = 22
    
        if (command == "reboot") {  // выполняем код при вызове спец команды из сценария: ID.reboot();
            ESP.restart();
        }

        return {};  // команда поддерживает возвращаемое значения. Т.е. по итогу выполнения команды или общения с внешней системой, можно вернуть значение в сценарий для дальнейшей обработки
    }
   
    ~SysExt() {};
};

void* getAPI_SysExt(String subtype, String param) {
    if (subtype == F("SysExt")) {
        return new SysExt(param);
    } else {
        return nullptr;
    }
}