Сценарии - noant/Lazurite GitHub Wiki

Одной из важнейших функциональностей Lazurite является возможность создавать сценарии. Сценарий - это действие, которое привязывается к элементу управления переключатель и в дальнейшем сценарий можно будет запускать с помощью этого переключателя со смартфона или из окна быстрого запуска на ПК. Помимо этого, сценарий можно запускать из другого сценария и из сценария другого сервера.

Меню выбора и редактирования сценариев.

Типы данных

Каждый сценарий (как и его переключатель) имеет свой тип данных. Под типом данных сценария предполагается то, в каком виде представлено состояние сценария. В Lazurite есть несколько типов данных:

Кнопка

Сценарий с этим типом данных принимает на вход только "нажатие" и не имеет никакого статуса. Как только пользователь запустит этот сценарий, должны произойти некоторые действия, но на самом переключателе это никак не отобразится.

Вид переключателя, который запускает сценарий с типом данных Кнопка.

Поменять иконку переключателя любого типа можно в меню сценариев.

Переключатель

Этот тип данных подразумевает то, что сценарий имеет два положения: включен и выключен. Обычно используется в тех случаях, когда следует включить или выключить какой-либо прибор или узнать значение параметра, который может быть только в двух положениях ("правда" или "ложь").

В качестве примера можно привести сценарий "Режим охраны". Пользователь может включить или выключить режим охраны, если не требуется каких-либо других вариантов (если они требуются, то нужно использовать тип данных Статус).

Вид переключателя, который находится в положении ВЫКЛЮЧЕН.

Вид переключателя, который находится в положении ВКЛЮЧЕН.

Число

Сценарий с типом данных Число имеет максимум и минимум, которые настраиваются в сценарии или в плагине. Пользователь может изменять позицию ползунка, в зависимости от его положения будет меняться значение сценария. Без типа данных Число невозможно создать такие сценарии, как "Уровень звука", "Яркость освещения", "Температура в комнате" и т.д.

Вид переключателя с типом данных Число.

При нажатии на переключатель будет открыто окно регулировки числового значения.

Регулировка значения на Windows.

Регулировка значения на Android.

Дата и время

Тип данных Дата позволяет создавать сценарии, завязанные на вводимую пользователем дату и время. Например, выполнить что-либо в заданный день и час.

Вид переключателя с типом данных Дата.

Регулировка значения на Windows.

Регулировка значения на Android.

Информация

Тип данных Информация позволяет пользователю вводить (или отображать ему) строковую информацию. Сценарий "Отправить сообщение пользователю" не может существовать без типа данных Информация.

Вид переключателя с типом данных Информация.

Ввод значения на Windows.

Ввод значения на Android.

Статус

Тип данных Статус позволяет отображать или вводить одно из заранее подготовленных значений. В качестве примера можно привести сценарий "Режим освещения". Когда пользователь будет создавать такой сценарий, он заранее введет несколько значений, которые сможет принимать этот сценарий, например, режим освещения "Ночной" или режим режим освещения "Праздник".

Вид переключателя с типом данных Статус.

Ввод значения на Windows.

Ввод значения на Android.

Геокоординаты

Тип данных Геокоординаты используется для отображения объекта на карте. Как правило, такой тип данных используется для отображения текущего положения пользователя, но нельзя исключать того, что будут созданы плагины, позволяющие отображать положение потерянных вещей с "маячком" или текущие геокоординаты автомобиля.

Вид переключателя с типом данных Геокоординаты.

При нажатии на переключатель откроется карта с отметкой.

Вывод координат на Android.

Для отображения на Windows используется браузер по умолчанию. Открывается в Яндекс картах.

Типы сценариев

Сценарии в Lazurite могут быть трех типов: одиночные действия, сложные сценарии и удаленные сценарии. При клике на кнопку "Добавить сценарий" появится окно выбора типа сценария.

Окно выбора типа сценария.
выбор сценария

Одиночное действие

Одиночные действия - это сценарии, не требующие сложной логики, такие как включение света или изменение уровня звука с помощью "плитки" в меню переключателей. В таком сценарии не получится создать цикл или условие, в нем можно лишь привязать отдельное действие из плагина к переключателю.

Конструктор одиночного действия.

Сложный сценарий

Сложный сценарий - это сценарии со сложной логикой, в котором есть циклы и условия. В нем можно настроить тип значения сценария (число, строка, переключатель, статус и т.д.).

Подробнее: Конструктор сложных сценариев

Конструктор сложных сценариев.

Удаленный сценарий

Удаленный сценарий позволяет запускать сценарий другого сервера, словно он был создан на локальной машине. Дальнейшее использование этого сценария в интерфейсе меню переключателей или в алгоритме комплексного сценария будет аналогично использованию других двух видов сценариев. Для создания сценария потребуется ввести адрес, порт, логин, пароль и секретный ключ сервиса Lazurite другой машины.

Конструктор удаленного сценария.

Далее: Конструктор сложных сценариев

⚠️ **GitHub.com Fallback** ⚠️