Глобальные переменные в Node-RED для сценариев Алисы

Стандартная модель передачи данных в Node-RED построена на концепции сообщений: объект msg перемещается по цепочке нод слева направо. Как только сообщение достигает конца цепочки, все содержащиеся в нем данные бесследно стираются из оперативной памяти сервера. Кроме того, одна изолированная цепочка (flow) не может напрямую прочитать данные из другой цепочки, находящейся на соседней вкладке редактора.

Для решения этой проблемы и создания сквозной логики умного дома в Node-RED применяется механизм контекстов (Contexts). Он позволяет сохранять информацию в специальные переменные, доступные на разных уровнях видимости. Это незаменимо для создания глобальных флагов (например, «Режим охраны», «Ночь», «Гости»), которые влияют на работу всех домашних сценариев Яндекса одновременно.

---

Шаг 1: Понимание уровней видимости контекста

В Node-RED существует три основных уровня хранения переменных:

1. Node Context (Контекст ноды) — данные доступны только внутри конкретной ноды, которая их записала. Используется крайне редко для специфических внутренних расчетов.
2. Flow Context (Контекст потока) — переменные доступны любым нодам, расположенным на одной и той же вкладке редактора Node-RED. Это удобно для объединения нескольких параллельных веток автоматизации одной комнаты.
3. Global Context (Глобальный контекст) — данные доступны абсолютно всем нодам на сервере автоматизации, независимо от того, на каких вкладках они находятся.

Для отслеживания глобальных режимов работы дома (например, спит ли кто-то в спальне или уехали ли хозяева в отпуск) всегда используется именно глобальный контекст.

---

Шаг 2: Запись и чтение переменных

Работать с переменными можно двумя способами: визуально с помощью стандартной ноды change или программно внутри ноды function.

Чтобы записать значение визуально:

1. Добавьте ноду change и выберите правило Set.
2. В поле назначения укажите область видимости, например flow.isNightMode или global.securityActive.
3. В поле значения введите нужную величину (логическое true/false, число или текстовую строку).

Программный способ в ноде function дает больше гибкости. Для записи данных используются встроенные методы .set(), а для чтения — .get():

// Запись переменной в глобальный контекст
global.set("lastMotionTime", Date.now());

// Чтение переменной из глобального контекста
const isNight = global.get("isNightMode") || false;

if (isNight) {
    msg.payload = { brightness: 10 }; // Ночной приглушенный режим
} else {
    msg.payload = { brightness: 100 }; // Дневной режим
}
return msg;

---

Шаг 3: Настройка энергонезависимого хранения данных

По умолчанию Node-RED хранит все контекстные переменные в оперативной памяти (RAM). Это означает, что при перезагрузке сервера автоматизации (например, при обновлении системы или внезапном отключении электричества) абсолютно все ваши глобальные переменные будут сброшены.

Чтобы переменные сохраняли свои значения после перезагрузки, необходимо настроить их запись на локальный диск сервера.

Для этого откройте конфигурационный файл settings.js вашего сервера Node-RED и найдите секцию contextStorage. Раскомментируйте ее и приведите к следующему виду:

contextStorage: {
    default: {
        module: "localfilesystem"
    }
}

После перезапуска службы Node-RED все данные будут автоматически дублироваться в файлы на жестком диске.

---

Шаг 4: Интеграция с Алисой и автоматами состояний

Глобальные переменные позволяют создавать сложные адаптивные сценарии. Например, умный настенный выключатель в прихожей при однократном нажатии включает свет, а при долгом удержании — меняет значение глобальной переменной global.awayMode на true.

Все остальные цепочки автоматизации (отопление, вентиляция, безопасность) периодически проверяют статус этой переменной. Яндекс Станция, зафиксировав переход флага awayMode в активное состояние, произносит: «Режим отсутствия активирован. Счастливого пути!», после чего выключает все розетки и переводит отопительный котел в экономичный режим.

Для реализации еще более сложных алгоритмов управления, основанных на отслеживании множества взаимосвязанных состояний комнат и переходов между ними, рекомендуется использовать специализированный автомат состояний в Node-RED. Это позволит объединить глобальные переменные в единую жесткую логическую систему.